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 广告接口
URI:http://mrobot.pconline.com.cn/v3/ad
请求方式:HTTPS GET
说明:广告接口
参数:
1). device :设备名
2). resolution :设备分辨率
返回(json格式):
{
“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 首页文章列表特型展示
URL: http://mrobot.pconline.com.cn/v2/cms/channels/1?pageSize=20&pageNo=1
请求方式:HTTP GET
说明:首页资讯列表 - 头条
返回(json格式):
普通文章类型:
{
"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
}
2.3 产品库 - 排行榜列表
URI:
请求方式:HTTP GET
说明:产品库 - 排行榜列表
返回(json格式)
{
"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”, //评价数
}
]
}
读取数据:
手机排行: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/
不需要分页,一次性获取排行榜列表。列表参数参考普通产品列表页,去掉详细参数,改成评价数。
2.4 栏目列表
iOS: http://mrobot.pconline.com.cn/configs/pconline_v7_cms_iphone_channel_tree
请求方式:HTTP GET
说明:获取栏目列表
返回(json格式)
{
"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"]
]
}
安卓:
安卓端默认定制排序:
头条 新闻 评测 图赏 手机 直播 视听(新增)
安卓端备选定制排序:
笔记本 平板 DIY外设(改名) 相机 无人机(新增) 家电 智能科技(新增) 软件 企业圈(新增) 网络圈(新增) 导购
iOS:
iOS端默认定制排序:
头条 Apple 新闻 评测 图赏 手机 直播 视听(新增)
iOS端备选定制排序:
笔记本 平板 DIY外设(改名) 相机 无人机(新增) 家电 智能科技(新增) 软件(iOS端新增) 企业圈(新增) 网络圈(新增) 导购
删除:
需要删除的:
行情、超级本、电视、摄像机、MID、企业