wiki:pconline_4.3.0/interface

Version 20 (modified by fuxingfang, 11 years ago) (diff)

--

Table of Contents

  1. 1.接口列表
    1. 1.1首页头条
    2. 1.2栏目定制
    3. 1.3论坛广场
    4. 1.4视频广告
    5. 1.5启动页
    6. 1.6搜索关键字接口
    7. 1.7文章终端页模板配置接口
    8. 1.8文章终端页一页加载

电脑网4.3.0接口文档

mrobot代理环境说明：

192.168.22.242:8888

1.接口列表

1.1首页头条

mrobot接口： http://mrobot.pconline.com.cn/v2/cms/channels/1?pageSize=20&pageNo=1&appVersion=4.3.0
后端接口：
ios： http://www.pconline.com.cn/app/21json/
android： http://www.pconline.com.cn/android/21json/
说明

1.cms在21json接口提供栏目id字段让mrobot判断“自媒体”文章的类型；

2.madmin增加一个为“视听”的“目标地址”类型，并增加主播名字段，由编辑录入

缓存时间

5min

提交方式

GET

是否登录

否

数据来源

CMS

参数

参数名 参数含义 类型 默认值 是否必需 说明
pageNo页码string 页码
pageSize每页条数string 每页条数
appVersion版本号string 版本号

返回 

{
    "articleList": [
        {
            "bigImage": "http://img0.pconline.com.cn/pconline/c_thumb.jpg",
            "cmtCount": 0,
            "id": "1234567",
            "image": "http://img0.xxx/123.jpg",
            "imageHor": "http://img0.xxx/1.jpg",
            "informationType": 8,  //8为自媒体
            "pubDate": "2015-7-22",
            "title": "标题标题标题",
            "url": "http://ivy.pconline.com.cn/xxxxx.html"
        }
    ],
    "focus": [],
    "pageNo": 1,
    "pageSize": 20,
    "topArticle": [
        {
            "image": "http://img.pconline.com.cn/images/8257.jpg",
            "informationType": 9,     //9为视听
            "isExtend": "0",
            "seq": 1,
            "title": “标题标题标题",     
            "anchor": “主播人：唐伯虎",    //主播名
            "to-uri": "http://g.pconline.com.cn/x/notebook/nbnews/ITnews/nbITnews/?FromApp&type=zt&browser=commonWebView&showShareButton=1",
            "updateAt": 1442851200000
        }
    ],
    "topFocus": [],
    "total": 200
}

返回参数说明

参数名 参数含义
anchor主播名 新增字段,当informationType=9为视听类型时才会返回该字段
informationType0:其他 1:文章 2:帖子 3:图集 4:直播 5:专题 6:聚超值 7:推广 8:自媒体(新增字段) 9:视听(新增字段)

1.2栏目定制

mrobot接口：
iOS： http://mrobot.pconline.com.cn/configs/pconline_v7_cms_iphone_channel_tree
Android： http://mrobot.pconline.com.cn/configs/pconline_v7_cms_android_channel_tree
说明

栏目定制增加图片URL

缓存时间

无

提交方式

GET

是否登录

否

数据来源

无

参数

无

返回 

{
    "news": [
        [
            "1",
            "头条",
            "609",
            "http://xxx.jpg"    //图标地址(新增字段)
        ],
        [
            "2",
            "新闻",
            "611"
            "http://xxx.jpg"    //图标地址(新增字段)
        ],
        [
            "4",
            "评测",
            "613",
            "http://xxx.jpg"    //图标地址(新增字段)
        ]
    ],
    "events": [],
    "product": [],
    "area": []
}

返回参数说明

参数名 参数含义

1.3论坛广场

mrobot接口： http://itbbs.pconline.com.cn/mobile/topics.ajax
说明

论坛广场每日热帖列表、论坛帖子列表页显示前三张缩略图(缩略图截取原图中间部分)，没有分页一次返回(客户端本地做分页，20条数据一页),列表接口需要做去重处理，【去重规则：帖子标题一样的。按发帖时间最早的显示】同时屏蔽摄影论坛的内容

缓存时间

无

提交方式

GET

是否登录

否

数据来源

论坛后台

参数

无

返回 

{
    "desc": "成功",
    "hot-topics": [
        {
            "createAt": "2015-09-21 13:29:29",
            "floor": 21,
            "forumId": 769033,
           "forumUrl": "http:\/\/itbbs.pconline.com.cn\/mobile\/f769246.html",
            "lastPostAt": "2015-09-21 15:04:11",
            "message": “9月18日凌晨我发现爱奇艺A.",
            "imgUrls": [
                       "http://imgxxx/c_thumb1.jpg",
                       "http://imgxxx/c_thumb2.jpg",   //三张缩略图
                       "http://imgxxx/c_thumb3.jpg"
                       ],
            "replyCount": 20,
            "rewardAmount": 0,
            "rewardRemain": 0,
            "title": "【福利】iPhone 6s免费赢取，你的6s手机壳准备好没有？？",
            "topicId": 52494120,
            "topicUrl": "http:\/\/itbbs.pconline.com.cn\/mobile\/52494120.html",
            "type": "其他",
            "userId": 33008677,
            "userName": “进阶强者",   //用户名
            "userImage": “",         //用户头像
            "userUrl": "http:\/\/my.pconline.com.cn\/33008677",
            "viewCount": 15430
        }
    ]
}

返回参数说明

参数名 类型 参数含义
imgUrls数组缩略图(最多返回三张，如果没有缩略图则无需返回)

1.4视频广告

mrobot接口： http://mrobot.pconline.com.cn/s/onlineinfo/ad/ad.xsp
后端接口：
 http://ivy.pconline.com.cn/adpuba/show?id=pc.khd.zx.zx4.&media=js
说明

广告系统新增视频音频标识（isMedia=1表示带视频或音频的广告，isMedia=0表示普通广告)

缓存时间

无

提交方式

GET

是否登录

否

数据来源

无

参数

无

返回 

{
    "twlb1": [
        {
            "seq": "5",
            "informationType": "7",
            "isMedia": “1",                   //判断是否包含视频、音频
            "image": "http://imgad0.pconline.com.cn/ivy/image/20154/2/14279648642540.jpg",
            "imageHor": "http://imgad0.pconline.com.cn/ivy/image/20158/5/14387708428240.jpg",
            "title": "首页图文列表第5位",
            "vc-uri": "http://ivy.pconline.com.cn/adpuba/show?adid=362147&id=test.xwx.khd.zx.zx5.&media=js",
            "to-uri": "http://ivy.pconline.com.cn/adpuba/click?adid=362147&id=test.xwx.khd.zx.zx5.",
            "vc3d-uri": "",
            "cc3d-uri": "",
            "cc-uri": ""
        }
    ],
    "jdt1": [
        {
            "seq": "3",
            "informationType": "7",
            "isMedia": “0",                     //判断是否包含视频、音频
            "image": "http://imgad0.pconline.com.cn/ivy/image/20158/3/14385953043150.jpg",
            "title": "LG G4奢华真皮版天猫上市 送多重好礼",
            "vc-uri": "http://ivy.pconline.com.cn/adpuba/show?adid=376156&id=pc.khd.zx.jdt.&media=js",
            "to-uri": "http://ivy.pconline.com.cn/adpuba/click?adid=376156&id=pc.khd.zx.jdt.",
            "vc3d-uri": "",
            "cc3d-uri": "",
            "cc-uri": ""
        }
    ]
}

返回参数说明

参数名 参数含义
isMedia0：表示普通广告 1:表示多媒体广告

1.5启动页

mrobot接口： http://mrobot.pconline.com.cn/pconline/skin
说明

Android因为不需要适配不同分辨率的机型，因此默认读取image字段，IOS那边则需要判断返回的JSON数据是否有’ios’这个属性有则读取对应的倍图没有则读取image字段过期时间CMS后台设置，当启动图过期时image字段返回为空即可

缓存时间

无

提交方式

GET

是否登录

否

数据来源

无

参数

无

返回 

{
      //默认启动图
      "image":"http://www.sinaimg.cn/qc/photo_auto/photo/50/11/1485011/1485011_src.jpg",
      //IOS的启动图 
      "ios":{
            // 针对I4以下机型
            "i4":"http://www.sinaimg.cn/qc/photo_auto/photo/50/11/1485011/1485011_src.jpg",
            //针对I5机型 
            "i5":"http://www.sinaimg.cn/qc/photo_auto/photo/50/11/1485011/1485011_src.jpg",
            //针对I6机型 
            "i6":"http://www.sinaimg.cn/qc/photo_auto/photo/50/11/1485011/1485011_src.jpg",
            //针对I6+机型
            "i6p":"http://www.sinaimg.cn/qc/photo_auto/photo/50/11/1485011/1485011_src.jpg"
       }
}

返回参数说明

参数名 参数含义
imageAndroid因为不需要适配不同分辨率的机型，因此默认读取image字段。为空则表示启动图过期或不存在
iosIOS那边则需要判断返回的JSON数据是否有’ios’这个属性有则读取对应的倍图没有则读取image字段过期时间CMS后台设置，当启动图过期时image字段返回为空即可（下面是对应IOS不同机型需要读取的字段)
i4针对I4以下机型(IOS客户端)
i5针对I5以下机型(IOS客户端)
i6针对I6以下机型(IOS客户端)
i6p针对I6+以下机型(IOS客户端)

1.6搜索关键字接口

mrobot接口： http://mrobot.pconline.com.cn/search/keyword
说明

备注：热门图集最多返回4个，热门新闻最多返回10条（在mrobot控制，后期变动直接改mrobot接口即可）。客户端拿到数据直接显示

缓存时间

无

提交方式

GET

是否登录

否

数据来源

无

参数

无

返回 

{
    "hot_keyword": "魅族",
    "hot_photo": [
        {
            "title": "关公战秦琼!戴尔XPS 13与苹果新本PK评测",   //标题
            "image": "http: //img0.xxx/123.jpg",  
            "to-uri": "pconlinebrowser://album-photo/14686"
        },
        {
            "title": "关公战秦琼!戴尔XPS 13与苹果新本PK评测",
            "image": "http://img0.xxx/123.jpg",
            "to-uri": "pconlinebrowser://album-photo/14686"
        }
    ],
    "hot_news": [
        {
            "id": "1234567",
            "cmtCount": 0,
            "image": "http://img0.xxx/123.jpg",
            "pubDate": "2015-7-22",
            "title": "标题标题标题",
            "url": "http://ivy.pconline.com.cn/xxxxx.html"
        },
        {
            "id": "1234567", 
            "cmtCount": 0,
            "image": "http://img0.xxx/123.jpg",
            "pubDate": "2015-7-22",
            "title": "标题标题标题",
            "url": "http://ivy.pconline.com.cn/xxxxx.html"
        }
    ]
}

返回参数说明

参数名 参数含义
hot_keyword搜索框关键字（只会返回一个)
hot_photo热门图集(以下三个参数是hot_photo段)
title标题
to-uri图集跳转协议
image图片URL
hot_news热门新闻(以下三个参数是hot_news段)
id新闻ID
cmtCount评论数
image图片URL
pubDate发表时间
title新闻标题
url文章跳转协议

1.7文章终端页模板配置接口

mrobot接口：
iOS： http://mrobot.pconline.com.cn/configs/pconline_ios_auto_update.json
Android： http://mrobot.pconline.com.cn/configs/pconline_android_auto_update.json
说明

目前的资讯文章终端页太大，拆分成css、js和html主体两个部分，其中css、js放客户端本地，html主体由mrobot接口给出；客户端需支持在线更新css、js功能

缓存时间

无

提交方式

GET

是否登录

否

数据来源

无

参数

无

返回 

{
     date: "2015-09-21 17:00:00",      
     patch-uri: "",                   
     patch-md5: "",                    
     resVer: 43000,                   
     description: ""                  
}

返回参数说明

参数名 参数含义
date更新时间
patch-uri下载地址
patch-md5md5校验串
resVer版本号
description描述

1.8文章终端页一页加载

mrobot接口： http://mrobot.pconline.com.cn/v3/cms/articles/7049937?articleTemplate=3.6.0&channelId=999&size=18&picRule=2&app=pconlinebrowser&template=(null)&appVersion=4.3.0&platform=android&deviceModel=SM-G9008V&resVer=43001

说明

1、文章在小于等于3页时，分页锚点按钮不需要出现；

2、文章大于3页时，文章页顶部出现锚点分页按钮，点击可弹出分页弹出层，点击小标题跳转该页锚点位置，锚点置顶。
3、文章依旧保持一页加载，并按需加载。

缓存时间

无

提交方式

GET

是否登录

否

数据来源

无

参数

参数名 类型 必须 说明
articleTemplateint是3.6.0(固定不变)
channelIdint是栏目ID
sizeint是字体大小
picRulestring是0小图，1无图，2大图
appstring是pconlinebrowser(固定不变)
templatestring是(null)(固定不变)
appVersionstring是版本号
platformstring是平台 android为platform=android,IOS为platform=ios
deviceModelstring否手机型号(只有android手机)
resVerstring是资源包版本号。resVer=43001，此版本号由app版本号和资源包迭代版本构成，如资源包第一版，resVer=43001；资源包第二版，resVer=43002，如此类推

返回 HTML页面里面的源码里面内嵌有JSON数据（内嵌JSON数据以/*@_HTML_META_START_开头并以_HTML_META_END_@*/，客户端自行读取) 

{
    "author": "lulijian",
    "firstPic": "http://img0.pconline.com.cn/pconline/1510/12/7045017_Screenshot_2015-10-12-13-23-07_thumb.png",
    "guidePic": "http://img0.pconline.com.cn/pconline/1509/30/g_7018278_1443581718563.jpg",
    "pageCount": 3,
    "pageNo": 2,
    "pages": [
        "Moto 360二代外观：颜值依旧称霸",
        "Android Wear 中国版：惨遭阉割",
        "Moto 360二代体验总结"
    ],
    "preView": "【PConline 评测】自第一代Moto 360发布以来，它就成为了Android Wear的标杆性产品，",
    "pubDate": "2015-10-13",
    "readonly": 0,
    "summary": "【PConline 评测】自第一代Moto 360发布以来，它就成为了Android Wear的标杆性产品，当然它也是很多用户心目中颜值最高的智能手表之一，其呼声甚至超过了如日中天的苹果产品Apple Watch。不断推陈出新是数码界的自然法则，而最近Moto 360已经推出了第二代产品，并且又在诸多细节上进行了调整。对于国内用户来说，更加喜人的是，Moto 360二代在国内进行了重新定制，并且也已经发布。PConline也在第一时间拿到了这款备受瞩目的产品。今天我们就带大家来实际体验一下这款产品，究竟这国内版的Moto 360二代好不好用。",
    "thumbPic": "http://img0.pconline.com.cn/pconline/1510/12/7045017_Screenshot_2015-10-12-13-23-07_thumb.png",
    "title": "颜值始终称霸！Moto360二代智能手表体验",
    "url": "http://wearable.pconline.com.cn/701/7018278.html",
    "wap_url": "http://g.pconline.com.cn/x/701/7018278.html"
}

锚点参数说明

锚点名为#号加标题名称，如"Moto360二代外观：颜值依旧称霸"的URL为
 http://mrobot.pconline.com.cn/v3/cms/articles/7049937?articleTemplate=3.6.0&channelId=999&size=18&picRule=2&app=pconlinebrowser&template=(null)&appVersion=4.3.0&platform=android&deviceModel=SM-G9008V&resVer=43001#Moto360二代外观：颜值依旧称霸 如此类推..