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 广告接口
1）mrobot接口url： http://mrobot.pconline.com.cn/v3/ad
2）后端接口：
HTTP请求方式：get
是否需要登录：否
返回格式：JSON
是否有缓存：否
请求参数：
platform //平台标识；android平台，platform=android；ios平台，platform=ios
device_model //设备机型
返回参数：
{
“xxx.xxx.xxx.610”: {
"cc-uri": "",
"image": "http://imgad0.pconline.com.cn/ivy/image/30.jpg",
"informationType": 7,
"pubDate": "2015-7-22",
"seq": 3,
"title": "标题标题标题",
"to-uri": "http://ivy.pconline.com.cn/xxxxx",
"vc-uri": "http://ivy.pconline.com.cn/xxx"
},
"pc.khd.zx.qdtdh.":
{
"ad":
{
"cc-uri":"",
"cc3d-uri":"",
"img":"http://imgad0.pconline.com.cn/ivy/image/20157/20/14373778828460.jpg",
"to-uri":”http://www.baidu.com”, //广告跳转链接
"vc-uri":"http://ivy.pconline.com.cn/adpuba/show?adid=376153&id=pc.khd.qdt.&media=js",
"vc3d-uri":""
},
"rule":
{
"age":3,
"delay":0,
"interval":1
}
}
}
注：“xxx.xxx.xxx”是广告标识类型，由广告系统自定义名称，后面610是栏目ID，如apple栏目是610。
2.2 首页文章列表特型展示
备注：首页资讯列表 - 头条
1）mrobot接口url：http://mrobot.pconline.com.cn/v2/cms/channels/1?pageSize=20&pageNo=1
2）后端接口：
HTTP请求方式：get
是否需要登录：否
返回格式：JSON
是否有缓存：有
缓存时间：5分钟
请求参数：
返回参数：
{
"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": 1,
"pubDate": "2015-7-22”,
"title": "标题标题标题”,
"url": “http://ivy.pconline.com.cn/xxxxx.html”,
},
//图集类型
{
"image": “http://imgxxx/c_thumb.jpg”, //兼容旧版，原字段保留
“imgUrls”: [
“http://imgxxx/c_thumb1.jpg”,
“http://imgxxx/c_thumb2.jpg”, //图集三张缩略图情况
“http://imgxxx/c_thumb3.jpg”
],
"imgCount": 15,
"informationType": 1,
"isExtend": “0”,
"preView": “文字文字文字”,
"pubDate": “2015-7-22”,
"seq": 7,
"title": "文字文字文字”,
“to-uri": “pconlinebrowser://album-photo/14686”,
"updateAt": 1437494400000
},
//直播类型
{
"cmtCount": 333,
"id": “471”,
"image": “http://img0.xxx/123.jpg”, //兼容旧版，原字段保留
"imageHor": “http://img0.xxx/1.jpg”, //横图
"informationType": 4,
"seq": 7,
"pubTime": “2015年6月2日至6日”,
"status": "直播已结束”,
"title": "标题标题标题”,
"url": “http://ivy.pconline.com.cn/xxxxx.html”,
},
//专题类型
{
"image": “http://imgxxx/c_thumb.jpg”, //兼容旧版，原字段保留
"imageHor": “http://img0.xxx/1.jpg”, //横图情况
"informationType": 5,
"isExtend": “0”,
"preView": “文字文字文字”,
"pubDate": “2015-7-22”,
"seq": 7,
"title": "文字文字文字”,
“to-uri": “pconlinebrowser://album-photo/14686”,
"updateAt": 1437494400000
}
],
"focus":
[],
"pageNo":
1,
"pageSize":
20,
"topArticle":
[],
"topFocus":
[],
"total":
200
}
2.3 产品库 - 排行榜列表
备注：产品库 - 排行榜列表。不需要分页，一次性获取排行榜列表。列表参数参考普通产品列表页，去掉详细参数，改成评价数。
数据来源：
手机排行：http://product.pconline.com.cn/hot/mobile/
相机排行：http://product.pconline.com.cn/hot/dc/
笔记本排行：http://product.pconline.com.cn/hot/notebook/
超极本排行：http://product.pconline.com.cn/hot/notebook/c12087/
平板排行：http://product.pconline.com.cn/hot/tabletpc/
1）mrobot接口url：
2）后端接口：
HTTP请求方式：get
是否需要登录：否
返回格式：JSON
是否有缓存：有
缓存时间：30分钟
请求参数：
返回参数：
{
"data":[
{
"id":576986, //产品id
"idxPic":"http://img.pconline.com.cn/images/product/5769/576986/q_cn.jpg”, //图片
"price":5288, //价格
"shortName":"三星Galaxy S6”, //名称
"commentScore”:90, //评分
“cmtNum”:12”, //评价数
}
]
}
2.4 栏目列表
备注：获取栏目列表
需求说明：
（1）安卓：
安卓端默认定制排序：头条 新闻 评测 图赏 手机 直播 视听(新增)
安卓端备选定制排序：笔记本 平板 DIY外设(改名) 相机 无人机(新增) 家电 智能科技(新增) 软件 企业圈(新增) 网络圈(新增) 导购
（2）iOS：
iOS端默认定制排序：头条 Apple 新闻 评测 图赏 手机 直播 视听(新增)
iOS端备选定制排序：笔记本 平板 DIY外设(改名) 相机 无人机(新增) 家电 智能科技(新增) 软件(iOS端新增) 企业圈(新增) 网络圈(新增) 导购
（3）删除：
需要删除的：行情、超级本、电视、摄像机、MID、企业
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
是否有缓存：无
请求参数：无
返回参数（iOS）：
{
"news":[
["1","头条","609”],
["5","Apple","610”],
["2","新闻","611”],
["4","评测","613”],
["11","图赏","859”],
["200","手机","614"],
["10","直播","612"],
["xx”,”视听","xxx”],
["300","笔记本","618”],
["400","平板","619"],
["120",”DIY外设","621”],
["500","相机","620”],
["xx”,”无人机","xxx”],
["600","家电","622"],
["xx”,"智能科技","xxx”],
[“xx”,"软件”,"xxx"],
["xx”,”企业圈”,"xxx”],
["xx”,”网络圈”,"xxx”],
["3","导购","616"],
],
"events": [],
"product": [],
"area": [
["100000", "全国", "6978"],
["110000", "北京", "6978"],
["310000", "上海", "6978"],
["440100", "广州", "6978"],
["440300", "深圳", "6978"],
["500000", "重庆", "6978"],
["210000", "辽宁", "6978"],
["350000", "福建", "6978"],
["330000", "浙江", "6978"],
["450000", "广西", "6978"],
["510100", "成都", "6978"],
["420100", "武汉", "6978"],
["120105", "河北", "6978"],
["230000", "黑龙江", "6978"],
["220403", "西安", "6978"],
["370000", "山东", "6978"],
["430000", "湖南", "6978"],
["410000", "河南", "6978"],
["360000", "江西", "6978"],
["810000", "香港", "6978"],
["440400", "珠海", "6978"],
["340000", "安徽", "6978"],
["460000", "海南", "6978"],
["320000", "江苏", "6978"],
["441900", "东莞", "6978"],
["120000", "天津", "6978"],
["330200", "宁波", "6978"],
["440600", "佛山", "6978"],
["210200", "大连", "6978"],
["130600", "保定", "6978"],
["441700", "阳江", "6621"]
]
}
2.5 文章终端页
备注：文章终端页有mrobot插入的广告：pc.khd.zx.wztl，需要做广告定向，因此客户端传定向相关参数给mrobot。
1）mrobot接口url：http://mrobot.pconline.com.cn/v3/cms/articles/6681159?articleTemplate=3.6.0&size=20&picRule=2&app=pconlinebrowser&template=(null)&channelId=0&serialId=0&appVersion=4.1.0
2）后端接口：
HTTP请求方式：get
是否需要登录：否
返回格式：html
是否有缓存：
请求参数：
appVersion //客户端版本，4.2.0
platform //平台标识；android平台，platform=android；ios平台，platform=ios
device_model //设备机型
返回参数：略
![(please configure the [header_logo] section in trac.ini)](http://www1.pconline.com.cn/hr/2009/global/images/logo.gif){kind=logo}
