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
}
 

2.3 首页 - 评论顶踩

备注：顶踩评论(评论取消顶踩接⼝，如果⽤户登录，则传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 产品库-推荐品牌列表

 备注:推荐品牌列表
 请求URL:http://mrobot.pconline.com.cn/v3/product/brandNameTopv36
 HTTP请求方式：get
 是否需要登录：否
 返回格式：json
 缓存方式：无
 缓存时间：无
 请求参数：无
返回参数：
{
    "手机": [
        "三星",
        "HTC",
        "诺基亚"
    ],
    "相机": [
        "佳能",
        "尼康",
        "索尼"
    ],
    "笔记本": [
        "联想",
        "惠普",
        "华硕"
    ],
    "DIY硬件": [
        "CPU",
        "显卡",
        "固态硬盘"
    ],
    "超极本": [
        "联想",
        "华硕",
        "索尼"
    ],
    "平板电脑": [
        "苹果",
        "三星",
        "ThinkPad"
    ],
    "数码产品": [
        "耳机",
        "移动硬盘",
        "游戏机"
    ],
    "硬件外设": [
        "键盘",
        "鼠标",
        "音箱"
    ],
    "数字家电": [
        "电视",
        "音响",
        "家庭影院"
    ],
    "摄像机": [
        "索尼",
        "松下",
        "佳能"
    ],
    "网络设备": [
        "无线路由",
        "上网卡"
    ],
    "企业办公": [
        "投影仪",
        "打印机",
        "扫描仪"
    ]
}

2.5 产品库-推荐品牌列表

 备注:推荐品牌列表
 请求URL:http://mrobot.pconline.com.cn/v3/product/brand/{分类id}
 HTTP请求方式：get
 是否需要登录：否
 返回格式：json
 缓存方式：无
 缓存时间：无
 请求参数：无
返回参数：
{
    "partition": {
        "recommondBrands": {
            "brands": [
                {
                    "id": 22586,                                                   //品牌ID
                    "logo": "http://www1.pconline.com.cn/app/brand/1sumsung.png",  //品牌logo      
                    "name": "三星"                                                 //品牌名称
                },
                {
                    "id": 22587,
                    "logo": "http://www1.pconline.com.cn/app/brand/2sony.png",
                    "name": "索尼"
                }
            ],
            "index": "荐",                                                        //品牌类型(推荐，A~Z)
            "rowNum": 18                                                          //数量
        },
        "totalBrands": {
            "sections": [
                {
                    "brands": [
                        {
                            "id": "47656",
                            "letter": "1",
                            "name": "17vee"
                        },
                        {
                            "id": "98234",
                            "letter": "1",
                            "name": "139易"
                        },
                        {
                            "id": "98421",
                            "letter": "1",
                            "name": "1-call"
                        },
                        {
                            "id": "99186",
                            "letter": "1",
                            "name": "100+"
                        }
                    ],
                    "index": "1",
                    "rowNum": 4
                },
                {
                    "brands": [
                        {
                            "id": "99214",
                            "letter": "2",
                            "name": "21克"
                        }
                    ],
                    "index": "2",
                    "rowNum": 1
                },
                {
                    "brands": [
                        {
                            "id": "94624",
                            "letter": "3",
                            "name": "35Phone"
                        },
                        {
                            "id": "97820",
                            "letter": "3",
                            "name": "3GNET三巨网"
                        }
                    ],
                    "index": "3",
                    "rowNum": 2
                },
                {
                    "brands": [
                        {
                            "id": "92183",
                            "letter": "A",
                            "name": "Altek"
                        },
                        {
                            "id": "22580",
                            "letter": "A",
                            "name": "阿尔卡特(ALCATEL)"
                        },
                        {
                            "id": "41896",
                            "letter": "A",
                            "name": "奥克斯(AUX)"
                        },
                        {
                            "id": "77989",
                            "letter": "A",
                            "name": "埃立特"
                        },
                        {
                            "id": "48969",
                            "letter": "A",
                            "name": "爱国者(aigo)"
                        },
                        {
                            "id": "96082",
                            "letter": "A",
                            "name": "艾炜特(IVT)"
                        },
                        {
                            "id": "90541",
                            "letter": "A",
                            "name": "Aoro"
                        }
                    ],
                    "index": "A",
                    "rowNum": 7
                },
                {
                    "brands": [
                        {
                            "id": "24132",
                            "letter": "B",
                            "name": "波导(Bird)"
                        },
                        {
                            "id": "80889",
                            "letter": "B",
                            "name": "笔电锋"
                        },
                        {
                            "id": "46201",
                            "letter": "B",
                            "name": "邦华(BOWAY)"
                        },
                        {
                            "id": "97972",
                            "letter": "B",
                            "name": "博沃BOVO"
                        },
                        {
                            "id": "98002",
                            "letter": "B",
                            "name": "百度卡美欧"
                        },
                        {
                            "id": "98171",
                            "letter": "B",
                            "name": "bee小蜜蜂"
                        },
                        {
                            "id": "99042",
                            "letter": "B",
                            "name": "博力信Broadsee"
                        }
                    ],
                    "index": "B",
                    "rowNum": 7
                }
            ],
            "total": 208
        }
    },
    "type": 20937
}

栏目配置

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字段

          }
}