![(please configure the [header_logo] section in trac.ini)](http://www1.pconline.com.cn/hr/2009/global/images/logo.gif){kind=logo}
| Version 5 (modified by wuchangbo, 11 years ago) (diff) |
|---|
电脑网4.3.0接口文档
mrobot代理环境说明：
192.168.22.242:8888
1.基本约定
接口通用参数 req_enc=utf-8(必须放url后面) resp_enc=utf-8(必须放url后面) common_session_id=xxxx(以cookies中的优先) 接口URL: 接口URL 必填参数：参数名=xxx(多种情况用括号解析) 非必填参数：参数名=xxx(多种情况用括号解析) 说明文档参数：添加某特定参数可以直接看接口文档 是否需要登录：是,否 返回格式：json,ssi,xml 缓存方式：接口缓存，对象缓存 缓存时间：缓存时间 返回结果：结果可能情况
2.接口列表
2.1首页头条
备注：cms需提供条件或者字段让mrobot判断文章的类型，并要增加主播名字段
1）mrobot接口url：http://mrobot.pconline.com.cn/v2/cms/channels/1?pageSize=20&pageNo=1
2）后端接口：[[BR]]
ios：http://www.pconline.com.cn/app/21json/
安卓：http://www.pconline.com.cn/android/21json/
HTTP请求方式：get
是否需要登录：否
返回格式：JSON
是否有缓存：有
返回参数：
{
"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": “标题标题标题", //标题
"host": “主播人：唐伯虎", //主播名
"to-uri": "http://g.pconline.com.cn/x/notebook/nbnews/ITnews/nbITnews/?FromApp&type=zt&browser=commonWebView&showShareButton=1",
"updateAt": 1442851200000
}
],
"topFocus": [],
"total": 200
}
2.2栏目定制
备注：栏目定制增加图片URL
1）mrobot接口url：
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
HTTP请求方式：get
是否需要登录：否
返回格式：JSON
是否有缓存：有
返回参数：
{
"news": [
[
"1",
"头条",
"609",
"http://xxx.jpg" //图标地址
],
[
"2",
"新闻",
"611"
"http://xxx.jpg" //图标地址
],
[
"4",
"评测",
"613",
"http://xxx.jpg" //图标地址
]
],
"events": [],
"product": [],
"area": []
}
2.3论坛广场
备注：论坛广场每日热帖列表、论坛帖子列表页增加三张缩略图，没有分页一次返回
1）mrobot接口url：http://itbbs.pconline.com.cn/mobile/topics.ajax
HTTP请求方式：get
是否需要登录：否
返回格式：JSON
是否有缓存：有
返回参数：
{
"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
}
]
}
2.4视频广告
备注：广告系统新增视频音频标识（isMedia=1表示带视频或音频的广告，isMedia=0表示普通广告)
1）mrobot接口url：http://mrobot.pconline.com.cn/s/onlineinfo/ad/ad.xsp
2）后端接口：[[BR]]
http://ivy.pconline.com.cn/adpuba/show?id=pc.khd.zx.zx4.&media=js
HTTP请求方式：get
是否需要登录：否
返回格式：JSON
是否有缓存：有
返回参数：
{
"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": ""
}
]
}
2.5启动页
备注：Android因为不需要适配不同分辨率的机型，因此默认读取image字段，IOS那边则需要判断返回的JSON数据是否有’ios’这个属性有则读取对应的倍图没有则读取image字段过期时间CMS后台设置，当启动图过期时image字段返回为空即可
1）mrobot接口url：http://mrobot.pconline.com.cn/pconline/skin
HTTP请求方式：get
是否需要登录：否
返回格式：JSON
是否有缓存：有
返回参数：
{
//默认启动图
"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"
}
}
2.6搜索关键字接口
备注：热门图集最多返回4个，热门新闻最多返回10条（在mrobot控制，后期变动直接改mrobot接口即可）。客户端拿到数据直接显示
1）mrobot接口url：http://mrobot.pconline.com.cn/search/keyword
HTTP请求方式：get
是否需要登录：否
返回格式：JSON
是否有缓存：有
返回参数：
{
"hot_keyword": "魅族",
"hot_photo": [
{
"title": "关公战秦琼!戴尔XPS 13与苹果新本PK评测", //标题
"image": "http: //img0.xxx/123.jpg",
"to-uri": "pconlinebrowser://album-photo/14686",
"imgCount": 15,
"isExtend": "0",
"preView": "文字文字文字",
"pubDate": "2015-7-22",
"updateAt": 1437494400000
},
{
"title": "关公战秦琼!戴尔XPS 13与苹果新本PK评测",
"image": "http://img0.xxx/123.jpg",
"to-uri": "pconlinebrowser://album-photo/14686",
"imgCount": 15,
"isExtend": "0",
"preView": "文字文字文字",
"pubDate": "2015-7-22",
"updateAt": 1437494400000
}
],
"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"
}
]
}
