[[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.1 [=#point201 首页 - 资讯列表] === {{{ 备注:此接口返回资讯消息列表,在返回字段里增加资讯类型 informationType = 0, //其他 informationType = 1, //文章 informationType = 2, //帖子 informationType = 3, //图集 informationType = 4, //新增直播类型 informationType = 5, //新增专题类型 informationType = 6, //新增聚超值类型 informationType = 7 //推广类型(广告)要求:1、17-18.5字, 2、加“推广”标签,3、要求能打开自己文章页也可以用webview打开客户指定网页。 专题类型时,to-uri字段指定专题页网址,且必须包含“type=zt”(旧版本就已经规定过);而且必须包含“browser=commonWebView”参数(表示用专题webview打开);参数“showShareButton={0或者1}”表示是否显示分享按钮,0不显示,1显示 mrobot接口:http://mrobot.pconline.com.cn/v2/cms/channels/1?pageNo=1&pageSize=20 文章页,需要提供只读字段(readonly true表示只读,false表示可读可评),以前接口就应该有该字段 后端接口:无 HTTP请求方式:get 是否需要登录:否 返回格式:json 缓存方式:无 缓存时间:无 请求参数: pageNo=页码 pageSize=一页条数,默认20,最大500 返回参数: { "articleList": [ //备注:此处无专题类型 { "bigImage": "http://img0.pconline.com.cn/pconline/1409/19/5460676_51_1k6tu9yn_thumb.jpg", "cmtCount": 文章评论数, "id": 文章id, "image": 文章图片地址, "pubDate": 发布时间, "title": 标题, "url": 文章详情地址, "readonly":true, "informationType": 资讯类型 } ], "focus": [ //备注:此处无专题类型 { "counter": "", "id": 文章id, "image": 文章图片地址,, "pubDate": 发布时间, "title": 标题, "url": 文章详情地址, "readonly":true, "informationType": 资讯类型 } ], "topArticle": [ //备注:只有这里有专题类型 { "image": "http://img.pconline.com.cn/images/upload/upc/tx/pc_best/1409/19/c2/38772308_1411119899458_width600.jpg", "preView": "其他类型的资讯,用全屏webview打开,类似聚超值类型", "pubDate": "2014-10-09", "seq": 7, "title": "LG G3移动版仅售3199元 Acer游戏本5K5历史新低", "to-uri": "http://g.pconline.com.cn/best/list_288.html?isShowHeader=0&ad=7265", "updateAt": 1412784000000, "informationType": 0 //其他类型 }, { "cmtCount": 26, "image": "http://img.pconline.com.cn/images/upload/upc/tx/itbbs/1410/09/c4/39422400_1412824208134_1024x1024.jpg", "preView": "64位双4G快时代!酷比魔方&联发科技4G战略发布会", "pubDate": "2014-10-09", "seq": 8, "title": "快时代!酷比魔方&联发科技4G战略发布会 参与互动送平板", "to-uri": "pconlinebrowser://information-article/322?template=live", "updateAt": 1412784000000, "informationType": 1 //文章类型 }, { "floorCount": 9, "image": "http://img.pconline.com.cn/images/upload/upc/tx/itbbs/1410/09/c3/39418150_1412820169882_1024x1024.jpg", "preView": "HTC发布的奇特造型RE相机新品,你喜欢吗?", "pubDate": "2014-10-09", "seq": 5, "title": "HTC发布的奇特造型RE相机新品,你喜欢吗?", "to-uri": "pconlinebrowser://bbs-topic/51812318", "updateAt": 1412784000000, "informationType": 2 //论坛类型 }, { "image": "http://img.pconline.com.cn/images/upload/upc/tx/itbbs/1410/09/c5/39426075_1412827383297_1024x1024.jpg", "imgCount": 17, "preView": "HTC Desire Eye手机和RE相机图赏\t", "pubDate": "2014-10-09", "seq": 6, "title": "HTC Desire Eye手机和RE相机图赏\t", "to-uri": "pconlinebrowser://album-photo/13404", "updateAt": 1412784000000, "informationType": 3 //图集类型 }, { "cmtCount": 279, "image": "http://img.pconline.com.cn/images/upload/upc/tx/itbbs/1410/08/c6/39379595_1412740065734_1024x1024.jpg", "preView": "[图文直播]HTC自拍神器旗舰新品发布会", "pubDate": "2014-10-09", "seq": 12, "title": "HTC自拍神器旗舰新品发布会回顾 Desire Eye手机及RE相机发布", "to-uri": "pconlinebrowser://information-article/323?template=live", "updateAt": 1412784000000, "informationType": 4 //直播类型 }, { "image": "http://img0.pcauto.com.cn/pcauto/1410/03/g_5242861_1412322026811_240x160.jpg", "preView": "2014巴黎车展:12款重磅SUV/即将引进", "pubDate": "2014-10-09", "seq": 17, "title": "2014巴黎车展:12款重磅SUV/即将引进", "to-uri": "http://www1.pcauto.com.cn/app/cheshi/index.html?type=zt&fromapp=1&browser=commonWebView", "updateAt": 1412784000000, "informationType": 5 //专题类型 }, { "image": "http://img.pconline.com.cn/images/upload/upc/tx/pc_best/1409/19/c2/38772308_1411119899458_width600.jpg", "preView": "今日聚超值", "pubDate": "2014-10-09", "seq": 7, "title": "LG G3移动版仅售3199元 Acer游戏本5K5历史新低", "to-uri": "http://g.pconline.com.cn/best/list_288.html?isShowHeader=0&ad=7265", "updateAt": 1412784000000, "informationType": 6 //聚超值类型 } ], "topFocus": [ //备注:此处无专题类型 { "cc-uri": "", "image": "http://imgad0.pconline.com.cn/ivy/image/20149/25/14116394470770.jpg", "seq": 3, "title": "广告", "to-uri": "http://ivy.pconline.com.cn/adpuba/click?adid=334508&id=pc.khd.zx.jdt.", "updateAt": 1412824722772, "vc-uri": "http://ivy.pconline.com.cn/adpuba/show?adid=334508&id=pc.khd.zx.jdt.&media=js" } ], ... "total": 文章总数量 } }}} === 2.2 [=#point202 首页 - 评论列表] === {{{ 备注:获取文章评论(需要提供户头像字段,userImg) 请求URL:http://mrobot.pcauto.com.cn/v3/cmt/new_topics/13118127?articleId=4147040&reverse=0&pageNo=1&pageSize=20 HTTP请求方式:get 是否需要登录:否 返回格式:json 缓存方式:无 缓存时间:无 请求参数: topicId:主题ID articleId:文章ID reverse:排序方式:0 倒序; 1 正序 pageNo:页码 pageSize:每页行数 请求后端URL: http://cmt.pcauto.com.cn/action/comment/list_new_json.jsp?tId=13118127&arch=0&reverse=0&pageSize=20 http://cmt.pcauto.com.cn/intf/tophot.jsp?tid=13118127 请求后端参数: tid:主题ID(从id_0取出) reverse:排序方式:0 倒序; 1 正序 pageSize:每页行数 返回参数: { "comments": [ { "1": { "client": "1", //客户端标识 "content": "1499 我买!", //评论内容 "floor": "25", //楼层 "id": "38918354", //评论id "name": "amumuANZ", //显示名称 "time": "2014-12-30 11:39:32", //评论时间 "userId": "34444661", //用户ID "userImg": "http://****" //用户头像 }, "current": "1", "expand": false, //是否展开 "support": "0" //顶的数量 }, { "1": { "client": "2", "content": "带通话功能就买。", "floor": "24", "id": "38918344", "name": "来自Android客户端网友", "time": "2014-12-30 11:39:22", "userId": "0" "userImg": "http://****" //用户头像 }, "current": "1", "expand": false, "support": "0" } ], "pageCount": 2, "pageNo": 1, "total": 25 } }}} === 2.3 [=#point203 首页 - 评论顶踩] === {{{ 备注:顶踩评论(评论取消顶踩接⼝,如果⽤户登录,则传common_session_id,如果⽤户没登录,则不传) 请求URL:http://cmt.pconline.com.cn/action/comment/support_json.jsp?cid=26821494&sp=1&common_session_id=**** HTTP请求方式:get 是否需要登录:否 返回格式:json 缓存方式:无 缓存时间:无 请求参数: cid:评论ID sp=1(顶数量+1) sp=-1(顶数量-1) 返回参数: { "support": 3, //顶数量 "floor": 3, //楼层 "status": 0, //状态,0表示成功 "topicId": 13118127, // "postId": 26821494 } }}} === 2.4 [=#point204 产品库-品牌筛选列表] === {{{ 备注:推荐品牌列表 请求URL:http://mrobot.pconline.com.cn/v2/product/models/criterion/{分类id} (筛选接口需要持新的筛选功能;⽀持“品牌选项”、 “更多选项”使多选; “价格选项”、 “排序选项”使单选) HTTP请求方式:get 是否需要登录:否 返回格式:json 缓存方式:无 缓存时间:无 请求参数:无 返回参数: { "criterion": [ { "cris": [ { "cId": "22586", "count": "220", "name": "三星", "value": 22586 }, { "cId": "46291", "count": "95", "name": "HTC", "value": 46291 } ], "name": "品牌", "value": "品牌" }, { "cris": [ { "count": "1000", "criId": "167", "name": "1000元以下", "value": "1 TO 999" }, { "count": "435", "criId": "169", "name": "1000-1500元", "value": "1000 TO 1500" }, { "count": "337", "criId": "170", "name": "1500-2000元", "value": "1500 TO 2000" }, { "count": "202", "criId": "171", "name": "2000-3000元", "value": "2000 TO 3000" }, { "count": "93", "criId": "173", "name": "3000-4000元", "value": "3000 TO 4000" }, { "count": "86", "criId": "3268", "name": "4000元以上", "value": "4001 TO 9999999" } ], "name": "价格", "value": "price_100" }, { "cris": [ { "count": "1000", "criId": "4927", "name": "GSM", "value": "GSM" }, { "count": "731", "criId": "4931", "name": "TD-SCDMA(移动3G)", "value": "TD-SCDMA(移动3G)" }, { "count": "1000", "criId": "4929", "name": "WCDMA(联通3G)", "value": "WCDMA(联通3G)" }, { "count": "345", "criId": "4930", "name": "CDMA2000(电信3G)", "value": "CDMA EV-DO(电信3G)" }, { "count": "90", "criId": "4934", "name": "双模(CDMA+GSM)", "value": "双模" } ], "name": "更多", "value": "更多" }, { "cris": [ { "count": "634", "criId": "12747", "name": "按价格", "value": "按价格" }, { "count": "608", "criId": "14266", "name": "按字母", "value": "按字母" } ], "name": "排序", "value": "排序" } ] } }}} === 2.5 [=#point205 产品库-品牌筛选列表] === {{{ 备注:进入找产品页,选择产品分类,进入品牌列表,选择筛选,选择筛选条件之后查询 请求URL:http://mrobot.pconline.com.cn/v3/product/models/search/{分类id}?pageNo=1&orderId=1 HTTP请求方式:post 是否需要登录:否 返回格式:json 缓存方式:无 缓存时间:无 请求参数:{ queryJson:{"品牌":["三星","苹果"],"价格":["1000元以下","4000元以上"],"更多":["TD-SCDMA(移动3G)","TD-SCDMA(移动4G)"],"屏幕大小":["14.0 TO 14.9","15.0 TO 15.9","13.0 TO 13.9"],"产品定位":["实用普及本","商用办公本","游戏影音本"],"品牌":[23906],"price_100":["3000 TO 3999"]}//查询的条件 pageNo:1//页码 orderId:1//排序条件 } 返回参数: 返回参数:{ data: [ { hotNew: 0, id: 548557, idxPic: "http://img.pconline.com.cn/images/product/5485/548557/01_cn.jpg", is-ultrabook: 0, items: [ "处理器", "Intel Core i5-3337U(1.8GHz/L3 3M)", "操作系统", "Windows 8", "内存容量", "6GB", "硬盘容量", "500GB", "屏幕尺寸", "15.6英寸", "分辨率", "1366×768", "显卡芯片", "AMD Radeon HD 8730M,+Intel HD 4000" ], noPriceMsg: "新品", price: 3999, shortName: "戴尔Inspiron灵越 15R(Ins15RD-2628)", url: "http://mrobot.pconline.com.cn/v3/product/abstact/548557" }, ], pageCount: 1, pageNo: 1, pageSize: 25, total: 2 } }}} === 2.6 [=#point206 图赏-推荐图集] === {{{ 备注:滚动到图集最后一张图后显示推荐图集 请求URL:http://mrobot.pconline.com.cn/v2/photo/recommendAlbums HTTP请求方式:get 是否需要登录:否 返回格式:json 缓存方式:无 缓存时间:15分钟 请求参数:无 返回参数: [ { "id": 130583,//图集id "image": "http://i3.3conline.com/images/piclib/201305/23/batch/1/176477/1369277363528pbshbw5puy_medium.jpg",//图集封面图,尺寸待定 "photoCount": "10",//图片数 "title": "图集标题" } ] }}} === 2.7 [=#point207 个人中心-用户信息] === {{{ 备注:个人中心,登录之后的用户信息 请求URL:http://mrobot.pconline.com.cn/v3/itbbs/getUserInfo HTTP请求方式:get 是否需要登录:是 返回格式:json 缓存方式:无 缓存时间:无 请求参数:无 返回参数: { "image": "http://i1.3conline.com/images/upload/upc/face/0/0_50x50", "userId": 0, "friends":关注好友数 "fans":粉丝数, } }}} === 2.8 [=#point208 个人中心-获取粉丝,关注列表] === {{{ 备注:返回包括粉丝,关注列表 请求URL: http://my.pconline.com.cn/intf/app/focus.jsp?accountId=31836836&act=findFocus&common_session_id=6E2073035FC49C29DD038821CAF2058F93196617DE299753&resp_enc=UTF-8&pageNo=1&pageSize=20&req_enc=UTF-8 HTTP请求方式:get 是否需要登录:是 返回格式:json 缓存方式:无 缓存时间:无 请求参数: accountId:用户ID,如果没有改参数的话则返回当前用户的好友列表 act:findFocus为关注,findFocusBy为粉丝 pageNo:页码 pageSize:页长度 common_session_id req_enc:UTF-8 resp_enc:UTF-8 返回参数: { "total":18, "pageCount":2, "pageNo":1, "pageSize":20, "resultList":[ { "accountId":用户ID "focusNum":关注好友数 "fanNum":粉丝数 "nickName":用户昵称 "image":头像 } ] } }}} === 2.9 [=#point209 个人中心-获取个人私信] === {{{ 备注:获取个人私信 请求URL:http://mrobot.pconline.com.cn/v3/bbs/getMessage?pageSize=20&pageNo=1&userId=24286812 HTTP请求方式:get 是否需要登录:否 返回格式:json 缓存方式:无 缓存时间:无 请求参数: common_session_id:用户登陆后获得的认证id userId:对方的用户id }}} == 栏目配置 == {{{ iOS: http://mrobot.pconline.com.cn/configs/pconline_v4_cms_iphone_channel_tree Android: http://mrobot.pconline.com.cn/configs/pconline_v4_cms_android_channel_tree }}} == 判断板块是否收藏 == {{{ URL:http://itbbs.pconline.com.cn/action/user/check_favorite.jsp 参数:fid //版块ID 是否要求登陆:是 方法:POST 返回结果: -1:参数错误/未登陆/非post提交/未收藏 2806152: 收藏id }}} == 个人中心推广活动 == {{{ URL:http://mrobot.pconline.com.cn/v2/cms/proxy?uri=http://app.pconline.com.cn/appnews/tghd/1403/intf4501.js 说明:uri参数部分需要按百分号转义 返回 {"data": [ { "title":"2014年日内瓦国际车展实时报道", "to-uri":"http://www1.pcauto.com.cn/mobile/2014rineiwachezhan/rineiwa/rineiwa.html?browser=commonwebview" } ] } }}} == 论坛树 == {{{ 论坛配置 http://mrobot.pconline.com.cn/configs/pconline_v4_bbs_forum_tree 增加最数码板块 层次结构:(id使用负数区分是否最数码论坛,对于最数码论坛使用不同的接口,使用实请自行把id转为正数) 最数码论坛 id -2 二手闲置交易 id -48 水聊地带 id -72 }}} == 最数码-发帖 == {{{ URL:http://mrobot.pconline.com.cn/proxy/piebbs/forums/76 参数:参考现有itbbs的发帖接口 返回:参考现有itbbs的发帖接口 }}} == 最数码-回帖 == {{{ URL:http://mrobot.pconline.com.cn/proxy/piebbs/topics/82417 参数:参考现有itbbs的回帖接口 返回:参考现有itbbs的回帖接口 }}} == 最数码-帖子终端页 == {{{ URL:http://mrobot.pconline.com.cn/v2/piebbs/topics/82417?pageNo=1&pageSize=19&picRule=2&authorId=0&topicTemplate=3.6.0&app=pconlinebrowser&size=18 参数:参考现有itbbs的帖子页 返回:参考现有itbbs的帖子页 }}} == 最数码-热门帖子列表 (待确认)== {{{ URL:http://mrobot.pconline.com.cn/proxy/piebbs/forums/2 }}} == 最数码-帖子列表 == {{{ URL: http://mrobot.pconline.com.cn/v2/piebbs/forums/48?&pageNo=1&pageSize=25&orderby=replyat 最后回复 http://mrobot.pconline.com.cn/v2/piebbs/forums/48?&pageNo=1&pageSize=25&orderby=postat 最后发表 http://mrobot.pconline.com.cn/v2/piebbs/forums/48?pageNo=1&pageSize=25&filter=pick 精华 http://mrobot.pconline.com.cn/v2/piebbs/forums/48?pageNo=1&pageSize=25&filter=top 置顶 参数:参考现有itbbs的帖子列表,48是板块id 返回:参考现有itbbs的帖子列表 }}} == 最数码-板块是否收藏 == {{{ URL:http://piebbs.pconline.com.cn/action/user/check_favorite.jsp 参数:参考上述“判断板块是否收藏”这一节 返回:参考上述“判断板块是否收藏”这一节 }}} === 同步内容下载 === {{{ url: 汽车网:http://mrobot.pcauto.com.cn/v3/bbs/collectionDownload/13128876?pageSize=20&pageNo=1 (已上线) 电脑网:http://mrobot.pconline.com.cn/v3/itbbs/collectionDownload/13128876?pageNo=1 (已上线) 作用:同步论坛收藏的内容 使用范围:电脑网app、汽车网app 请求方式:get 是否需要登录:是 请求参数: common_session_id:用户登陆后获得的认证id pageSize:每页的数据量,只对论坛和帖子起作用;假如pageSize=20,那么论坛和帖子分别返回20条数据 pageNo:页码 注:seriesList,modelList为汽车网客户端独有, pieForumList, pieTopicList为电脑网客户端独有 例子: { "pieforumCount":0, //接口出分页较为麻烦,最数码论坛本字段无效 "pieforumPageCount":0, //接口出分页较为麻烦,最数码论坛本字段无效 "pietopicCount":0, //接口出分页较为麻烦,最数码论坛本字段无效 "pietopicPageCount":0, //接口出分页较为麻烦,最数码论坛本字段无效 "forumCount":0, "forumPageCount":0, "topicCount":0, "topicPageCount":0, "pageCount":100, //如果论坛版块的总页数大于帖子的总页数就使用论坛的总页数,否则使用帖子的总页数 "pageNo":2, //页码 "total":38, //帖子和论坛版块的总数 “seriesList”:[//车系 { “id”:1234, //爱车id “seriesId”:145,//车系id “name”:”宝马3系”, //车系名字 “image”:http://mrobot.pcauto.com/baoma3.jpg //车系小图url }, { “id”:1234, //爱车id “seriesId”:145,//车系id “name”:”宝马”, //车系名字 “image”:http://mrobot.pcauto.com/baoma.jpg //车系小图url } ], “modelList”:[//车型 { “id”:1234, //爱车id “modelId”:145,//车型id “name”:”宝马”, //车型名字 “image”:http://mrobot.pcauto.com/baoma.jpg //车型小图url }, { “id”:1234, //爱车id “modelId”:145,//车型id “name”:”宝马”, //车型名字 “image”:http://mrobot.pcauto.com/baoma.jpg //车型小图url } ], “forumList”:[//论坛 { “id”:1234, //收藏id “forumId”:145,//论坛版块id “name”:”宝马”, //论坛名字 }, { “id”:1234, //收藏id “forumId”:145,//论坛版块id “name”:”宝马”, //论坛名字 } ], “topicList”:[//帖子 { “id”:1234, //收藏id “topicId”:145,//帖子id “name”:”宝马3系太好了”, //帖子标贴 }, { “id”:1234, //收藏id “topicId”:145,//帖子id “name”:”宝马3系太好了”, //帖子标贴 } ], “pieForumList”:[//最数码论坛 { “id”:1234, //收藏id “forumId”:145,//论坛版块id “name”:”宝马”, //论坛名字 }, { “id”:1234, //收藏id “forumId”:145,//论坛版块id “name”:”宝马”, //论坛名字 } ], “pieTopicList”:[//最数码帖子 { “id”:1234, //收藏id “topicId”:145,//帖子id “name”:”宝马3系太好了”, //帖子标贴 }, { “id”:1234, //收藏id “topicId”:145,//帖子id “name”:”宝马3系太好了”, //帖子标贴 } } }}} === 同步内容上传 === {{{ 汽车网:http://mrobot.pcauto.com.cn/v3/bbs/collectionUpload (已上线) 电脑网:http://mrobot.pconline.com.cn/v3/itbbs/collectionUpload (已上线) 作用:同步论坛收藏的内容 使用范围:电脑网app、汽车网app 请求方式:post 是否需要登录:是 请求参数: common_session_id:用户登陆后获得的认证id json:需要上传的数据提交给该参数。 注:series,model为汽车网客户端独有 pieforum, pietopic为电脑网客户端独有 例子: { “series”:{ //车系 “addList”:[123121,1111,2222,3333,566788], //新增车系id数组,此处的id即为同步下载接口中的seriesId,没有新增的车系该字段留空,即“addList”:[],如下同。 “deleteList”:[12356,6666,5555,32145] //删除车系数组,此处的id为爱车id,即为同步下载接口中seriesList下的id字段 }, "model":{ //车型 “addList”:[{serialId:111, modelId:111},{serialId:111, modelId:111}], //新增车型id数组,serialId为车系id,modelId为车型id “deleteList”:[12356,6666,5555,32145] //删除车型数组,此id为爱车id,即为同步下载接口中modelList的id字段 }, “forum”:{ //论坛 “addList”:[123121,1111,2222,3333,566788], //新增论坛id数组,此处的id即为同步下载接口中的forumId “deleteList”:[12356,6666,5555,32145], //删除论坛数组,此id为收藏id,即为同步下载接口中forumList下的id字段 }, “topic”:{ //帖子 “addList”:[123121,1111,2222,3333,566788], //新增帖子id数组,此处的id即为同步下载接口中的topicId “deleteList”:[12356,6666,5555,32145], //删除论坛数组,此id为收藏id,即为同步下载接口中topicList下的id字段 } “pieforum”:{ //论坛 “addList”:[123121,1111,2222,3333,566788], //新增论坛id数组,此处的id即为同步下载接口中的forumId “deleteList”:[12356,6666,5555,32145], //删除论坛数组,此id为收藏id,即为同步下载接口中forumList下的id字段 }, “pietopic”:{ //帖子 “addList”:[123121,1111,2222,3333,566788], //新增帖子id数组,此处的id即为同步下载接口中的topicId “deleteList”:[12356,6666,5555,32145], //删除论坛数组,此id为收藏id,即为同步下载接口中topicList下的id字段 } } }}}