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 首页 - 资讯列表
备注：此接口返回资讯消息列表，在返回字段里增加资讯类型
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 首页 - 评论列表
备注：获取文章评论（需要提供户头像字段,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
}
栏目配置
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字段
}
}
![(please configure the [header_logo] section in trac.ini)](http://www1.pconline.com.cn/hr/2009/global/images/logo.gif){kind=logo}
