[[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 后端接口：无 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": 文章详情地址, "informationType": 资讯类型 } ], "focus": [ //备注：此处无专题类型 { "counter": "", "id": 文章id, "image": 文章图片地址,, "pubDate": 发布时间, "title": 标题, "url": 文章详情地址, "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": 文章总数量 } }}} == 栏目配置 == {{{ 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字段 } } }}}