[[TOC]] == 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.0 [=#point200 广告标识配置接口] === '''(mrobot已完成开发,请连开发机进行测试)'''[[BR]] {{{ 备注:此为广告标识配置接口,由mrobot使用,客户端可用不用理会。接口里面的有些广告标识可能只是测试标识,我们关注的重点是整体的数据结构 1)接口url:http://mrobot.pconline.com.cn/configs/pconline_v2_ads HTTP请求方式:get 是否需要登录:否 返回格式:JSON 是否有缓存:无 缓存时间:无 请求参数:无 返回参数: { { "btxwz": [ { "adsServerId": "pc.khd.zx.btxfwz.", "adsClientId": "pc.khd.zx.btxfwz.", "comment": "文章页标题下方文字" }, { "adsServerId": "test.xwx.khd.dx.btxfwz.5.", "adsClientId": "pc.khd.zx.btxfwz.5.", "comment": "文章页标题下方文字(定向投放栏目5)" } ], "btxwzxj": { "adsServerId": "pc.khd.zx.btxfldxj.", "adsClientId": "pc.khd.zx.btxfwzxj.", "comment": "标题下方文字下加(此广告已作废)" }, "plytgw": [ { "adsServerId": "pc.khd.zx.pltl.", "adsClientId": "pc.khd.zx.plytgw.", "comment": "评论页评论区域通栏" }, { "adsServerId": "test.xwx.khd.zx.jdt4.", "adsClientId": "pc.khd.zx.plytgw.2.", "comment": "评论页评论区域通栏(定向投放栏目2)" } ], "wzdb": [ { "adsServerId": "pc.khd.zx.wztl.", "adsClientId": "pc.khd.zx.wztl.", "comment": "文章页评论区域通栏" }, { "adsServerId": "test.xwx.khd.zx.jdt4.", "adsClientId": "pc.khd.zx.wztl.2.", "comment": "文章页评论区域通栏(定向投放栏目2)" } ], "wzdl": [ { "adsServerId": "pc.khd.zx.dbtl.", "adsClientId": "pc.khd.zx.dbtl.", "comment": "文章页底部通栏" }, { "adsServerId": "test.xwx.khd.zx.zx5.", "adsClientId": "pc.khd.zx.dbtl.3.", "comment": "文章页底部通栏(定向投放栏目3)" } ], "syjdt": [ { "id": "pc.khd.zx.syjdt.", "comment": "首页焦点图特批", "extPara1": "mopentype=browserdirectlyopen" }, { "id": "pc.khd.zx.jdt.", "comment": "首页焦点图第3则", "extPara1": "mopentype=browserdirectlyopen" }, { "id": "pc.khd.zx.jdt4.", "comment": "首页焦点图第4则", "extPara": "mopentype=browserdirectlyopen" }, { "id": "pc.khd.zx.jdt5.", "comment": "首页焦点图第5则" } ], "twlb": { "twlb1": [ { "id": "pc.khd.zx.zx4.", "comment": "首页图文列表第4位" }, { "id": "pc.khd.zx.zx5.", "comment": "首页图文列表第5位" }, { "id": "pc.khd.zx.zx7.", "comment": "首页图文列表第7位" }, { "id": "pc.khd.zx.zx10.", "comment": "首页图文列表第10位" }, { "id": "pc.khd.zx.zx20.", "comment": "首页图文列表第20位" } ], "twlb2": [ { "id": "pc.khd.pd.xw.zx3.", "comment": "新闻栏目图文列表第3位" } ], "twlb3": [ { "id": "pc.khd.pd.zg.zx3.", "comment": "导购栏目图文列表第3位" } ], "twlb4": [ { "id": "pc.khd.pd.pc.zx3.", "comment": "评测栏目图文列表第3位" } ], "twlb5": [ { "id": "test.xwx.khd.zx.zx3.", "comment": "APPLE栏目图文列表第3位" } ], "twlb120": [ { "id": "pc.khd.pd.diy.zx3.", "comment": "DIY外设栏目图文列表第3位" } ], "twlb200": [ { "id": "pc.khd.pd.sj.zx3.", "comment": "手机栏目图文列表第3位" } ], "twlb300": [ { "id": "pc.khd.pd.bjb.zx3.", "comment": "笔记本栏目图文列表第3位" } ], "twlb400": [ { "id": "pc.khd.pd.pb.zx3", "comment": "平板栏目图文列表第3位" } ], "twlb500": [ { "id": "pc.khd.pd.xj.zx3", "comment": "相机栏目图文列表第3位" } ], "twlb600": [ { "id": "pc.khd.pd.jd.zx3", "comment": "家电栏目图文列表第3位" } ] }, "qpfmt": { "adsServerId": "pc.khd.zx.fmt.", "adsClientId": "pc.khd.zx.fmt.", "comment": "全屏富媒体(此广告已作废)" }, "fdgg": { "adsServerId": "pc.khd.zx.fdgg.", "adsClientId": "pc.khd.zx.fdgg.", "comment": "浮动广告(此广告已作废)" }, "qpgg": { "adsServerId": "pc.khd.zx.qp.", "adsClientId": "pc.khd.zx.qp.", "comment": "全屏广告(此广告已作废)" }, "qdtdh": { "adsServerId": "pc.khd.qdt.", "adsClientId": "pc.khd.zx.qdtdh.", "comment": "启动图动画" }, "qdtdh_best": { "adsServerId": "pc.khd.best.qdtdh.", "adsClientId": "pc.khd.best.qdtdh.", "comment": "启动图动画_聚超值" } } }}} === 2.1 [=#point201 广告接口] === '''(mrobot已完成开发,请连开发机进行测试)'''[[BR]] {{{ 1)mrobot接口url: http://mrobot.pconline.com.cn/v3/ad 2)后端接口:http://ivy.pconline.com.cn/adpuba/show?id=test.xwx.khd.zx.qdtdh.&media=js HTTP请求方式:get 是否需要登录:否 返回格式:JSON 是否有缓存:否 请求参数: platform //平台标识;android平台,platform=android;ios平台,platform=ios deviceModel //设备机型 返回参数: { "twlb1": [//首页栏目信息流广告。显而易见地,此处的字段名"twlb1"采用的是twlb+channelId的方式命名的,即"twlb"为固定的,1为channelId(即栏目id),客户端用channelId定位栏目 { "seq": "5", "img": "http://imgad0.pconline.com.cn/ivy/image/20154/2/14279648642540.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": "" } ], "twlb5": [//第5栏目(即APPLE栏目)信息流广告 { "seq": "3", "img": "http://imgad0.pconline.com.cn/ivy/image/20154/2/14279648642540.jpg", "title": "APPLE栏目图文列表第3位", "vc-uri": "http://ivy.pconline.com.cn/adpuba/show?adid=362147&id=test.xwx.khd.zx.zx3.&media=js", "to-uri": "http://ivy.pconline.com.cn/adpuba/click?adid=362147&id=test.xwx.khd.zx.zx3.", "vc3d-uri": "", "cc3d-uri": "", "cc-uri": "" } ], "jdt1": [//首页焦点图广告。显而易见地,此处的字段名"jdt1"采用的是jdt+channelId的方式命名的,即"jdt"为固定的,1为channelId(即栏目id),客户端用channelId定位栏目 { "seq": "3", "img": "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": "" }, { "seq": "4", "img": "http://imgad0.pconline.com.cn/ivy/image/20155/28/14328095595520.jpg", "title": "LG G4 京东首发 多重大礼", "vc-uri": "http://ivy.pconline.com.cn/adpuba/show?adid=367973&id=pc.khd.zx.jdt5.&media=js", "to-uri": "http://ivy.pconline.com.cn/adpuba/click?adid=362147&id=test.xwx.khd.zx.jdt4.&mopentype=browserdirectlyopen", "vc3d-uri": "", "cc3d-uri": "", "cc-uri": "" } ], "pc.khd.zx.btxfwz.": {//文章页标题下方文字 "ads": [ { "text": "LG G4奢华真皮版天猫上市 送多重好礼", "vc-uri": "http://ivy.pconline.com.cn/adpuba/show?adid=376150&id=pc.khd.zx.btxfwz.&media=js", "to-uri": "http://ivy.pconline.com.cn/adpuba/click?adid=376150&id=pc.khd.zx.btxfwz.", "vc3d-uri": "", "cc3d-uri": "", "cc-uri": "" } ] }, "online.khd.zx.btxwz.": {//文章页标题下方文字,此字段名是为了兼容很久以前的app的,新版app可以不理 "ads": [ { "text": "LG G4奢华真皮版天猫上市 送多重好礼", "vc-uri": "http://ivy.pconline.com.cn/adpuba/show?adid=376150&id=pc.khd.zx.btxfwz.&media=js", "to-uri": "http://ivy.pconline.com.cn/adpuba/click?adid=376150&id=pc.khd.zx.btxfwz.", "vc3d-uri": "", "cc3d-uri": "", "cc-uri": "" } ] }, "pc.khd.zx.btxfwz.5.": {//文章页标题下方文字,定向投放到栏目5。显而易见地,此处的字段名是采用pc.khd.zx.btxfwz.channelId.方式命名的,5即为channelId(栏目id) "ads": [ { "text": "康宁大猩猩玻璃", "vc-uri": "http://ivy.pconline.com.cn/adpuba/show?adid=362147&id=test.xwx.khd.dx.btxfwz.5.&media=js", "to-uri": "http://ivy.pconline.com.cn/adpuba/click?adid=362147&id=test.xwx.khd.dx.btxfwz.5.", "vc3d-uri": "", "cc3d-uri": "", "cc-uri": "" } ] }, "pc.khd.zx.plytgw.": {//评论页评论区域通栏 "ads": [ { "img": "http://imgad0.pconline.com.cn/ivy/image/20155/28/14328095595520.jpg", "text": "LG G4 京东首发 多重大礼", "vc-uri": "http://ivy.pconline.com.cn/adpuba/show?adid=367973&id=pc.khd.zx.jdt5.&media=js", "to-uri": "http://ivy.pconline.com.cn/adpuba/click?adid=362147&id=test.xwx.khd.zx.jdt4.", "vc3d-uri": "", "cc3d-uri": "", "cc-uri": "" } ] }, "pc.khd.zx.plytgw.2.": {//评论页评论区域通栏,定向投放到栏目2。显而易见地,此处的字段名是采用pc.khd.zx.plytgw.channelId.方式命名的,2即为channelId(栏目id) "ads": [ { "img": "http://imgad0.pconline.com.cn/ivy/image/20155/28/14328095595520.jpg", "text": "LG G4 京东首发 多重大礼", "vc-uri": "http://ivy.pconline.com.cn/adpuba/show?adid=367973&id=pc.khd.zx.jdt5.&media=js", "to-uri": "http://ivy.pconline.com.cn/adpuba/click?adid=362147&id=test.xwx.khd.zx.jdt4.", "vc3d-uri": "", "cc3d-uri": "", "cc-uri": "" } ] }, "pc.khd.zx.wztl.": {//文章页评论区域通栏。此广告mrobot会在页面处理,客户端不用处理 "ads": [ { "img": "http://imgad0.pconline.com.cn/ivy/image/20154/2/14279648642540.jpg", "text": "首页图文列表第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": "" } ] }, "pc.khd.zx.wztl.2.": {//文章页评论区域通栏,定向投放到栏目2。显而易见地,此处的字段名是采用pc.khd.zx.wztl.channelId.方式命名的,2即为channelId(栏目id)。此广告mrobot会在页面处理,客户端不用处理 "ads": [ { "img": "http://imgad0.pconline.com.cn/ivy/image/20155/28/14328095595520.jpg", "text": "LG G4 京东首发 多重大礼", "vc-uri": "http://ivy.pconline.com.cn/adpuba/show?adid=367973&id=pc.khd.zx.jdt5.&media=js", "to-uri": "http://ivy.pconline.com.cn/adpuba/click?adid=362147&id=test.xwx.khd.zx.jdt4.", "vc3d-uri": "", "cc3d-uri": "", "cc-uri": "" } ] }, "pc.khd.zx.dbtl.": {//文章页底部通栏 "rule": { "delay": 0, "interval": 120, "age": 10 }, "ad": { "img": "http://imgad0.pconline.com.cn/ivy/image/20154/2/14279648642540.jpg", "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": "" } }, "pc.khd.zx.dbtl.3.": {//文章页底部通栏,定向投放到栏目3。显而易见地,此处的字段名是采用pc.khd.zx.dbtl.channelId.方式命名的,3即为channelId(栏目id) "rule": { "delay": 0, "interval": 120, "age": 10 }, "ad": { "img": "http://imgad0.pconline.com.cn/ivy/image/20154/2/14279648642540.jpg", "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": "" } }, "pc.khd.zx.qdtdh.": {//启动图广告 "rule": { "delay": 0, "interval": 1, "age": 3 }, "ad": { "img": "http://imgad0.pconline.com.cn/ivy/image/20156/17/14345350437860.jpg", "vc-uri": "http://ivy.pconline.com.cn/adpuba/show?adid=362147&id=test.xwx.khd.zx.qdtdh.&media=js", "to-uri": "http://ivy.pconline.com.cn/adpuba/click?adid=362147&id=test.xwx.khd.zx.qdtdh.", "vc3d-uri": "", "cc3d-uri": "", "cc-uri": "" } }, "online.khd.zx.qdtdh.": {//启动图广告,此字段名是为了兼容很久以前的app的,新版app可以不理 "rule": { "delay": 0, "interval": 1, "age": 3 }, "ad": { "img": "http://imgad0.pconline.com.cn/ivy/image/20156/17/14345350437860.jpg", "vc-uri": "http://ivy.pconline.com.cn/adpuba/show?adid=362147&id=test.xwx.khd.zx.qdtdh.&media=js", "to-uri": "http://ivy.pconline.com.cn/adpuba/click?adid=362147&id=test.xwx.khd.zx.qdtdh.", "vc3d-uri": "", "cc3d-uri": "", "cc-uri": "" } } } }}} === 2.2 [=#point202 首页文章列表特型展示] === '''(mrobot已完成开发,请连开发机进行测试)'''[[BR]] {{{ 备注:首页资讯列表 - 头条 1)mrobot接口url:http://mrobot.pconline.com.cn/v2/cms/channels/1?pageSize=20&pageNo=1 2)后端接口:http://www.pconline.com.cn/app/21json/ http://www.pconline.com.cn/android/21json/ HTTP请求方式:get 是否需要登录:否 返回格式:JSON 是否有缓存:有 缓存时间:5分钟 请求参数:新增如下请求参数: appVersion //客户端版本,4.2.0 返回参数: { "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 [=#point203 产品库 - 排行榜列表] === '''(mrobot已完成开发,请连开发机进行测试)'''[[BR]] {{{ 备注:产品库 - 排行榜列表。不需要分页,一次性获取排行榜列表。列表参数参考普通产品列表页,去掉详细参数,改成评价数。 数据来源: 手机排行: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:http://mrobot.pconline.com.cn/v3/product/rankList 2)后端接口:http://pdhot.pconline.com.cn/api/rankList.jsp HTTP请求方式:get 是否需要登录:否 返回格式:JSON 是否有缓存:有 缓存时间:1小时 请求参数: rlid:分类id,手机701,相机696,笔记本702,超级本697,平板703 返回参数: { "data":[ { "productId":576986, //产品id "idx2PictureUrl":"http://img.pconline.com.cn/images/product/5769/576986/q_cn.jpg”, //图片 "price":5288, //价格 "name":"三星Galaxy S6”, //名称 "commentScore”:90, //评分 “cmtNum”:12”, //评价数 } ] } }}} === 2.4 [=#point204 栏目列表] === {{{ 备注:获取栏目列表 需求说明: (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 [=#point205 文章终端页] === '''(mrobot已完成开发,请连开发机进行测试)'''[[BR]] {{{ 备注:文章终端页有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://192.168.10.67:8002/interface/pconline/mrobot_articles_v2.jsp?ids=6690076 http://192.168.237.8/pconline_cms/select?q= http://pdlib.pconline.com.cn/product/intel/base_info_json.jsp?productId= http://priceparity.pconline.com.cn/intf/price_list_for_app.jsp?productId= http://cmt.pconline.com.cn/action/topic/get_data.jsp?url= http://cmt.pconline.com.cn/action/comment/list_new_json.jsp http://cmt.pconline.com.cn/intf/tophot.jsp HTTP请求方式:get 是否需要登录:否 返回格式:html 是否有缓存:有 缓存时间:1小时 请求参数:新增如下请求参数: appVersion //客户端版本,4.2.0 platform //平台标识;android平台,platform=android;ios平台,platform=ios deviceModel //设备机型 返回参数:略 }}}