[[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 首页 - 评论列表] ===
{{{
备注：获取文章评论（需要提供户头像字段,face）
 请求URL：http://mrobot.pconline.com.cn/v3/cmt/new_topics/13118127?reverse=0&pageNo=1&pageSize=20
 HTTP请求方式：get
 是否需要登录：否
 返回格式：json
 缓存方式：无
 缓存时间：无
 请求参数：
        topicId：主题ID
        articleId：文章ID
        reverse：排序方式：0  倒序； 1 正序
        pageNo：页码
        pageSize：每页行数
 返回参数:
{
    "comments": [
        {
            "1": {
                "client": "1",                      //客户端标识
                "content": "1499  我买！",          //评论内容
                "floor": "25",                      //楼层
                "id": "38918354",                   //评论id
                "name": "amumuANZ",                 //显示名称
                "time": "2014-12-30 11:39:32",      //评论时间
                "userId": "34444661",               //用户ID
                "face": "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"
                "face": "http://****"            //用户头像
            },
            "current": "1",
            "expand": false,
            "support": "0"
        }
    ],
    "pageCount": 2,
    "pageNo": 1,
    "total": 25
}
 
}}}

=== 2.3 [=#point203 首页 - 文章顶踩、取消顶踩新接口] ===
{{{
备注：该接口已经合并顶踩和取消顶踩功能(如果⽤户登录，则传common_session_id，如果⽤户没登录，则不传)；直接使用Web端接口；HTTP请求方式为POST（参考bip接口文档）
mrobot url：暂无
Web端 url：http://bip.pconline.com.cn/intf/article.jsp?act=delOrAddArtAgree&siteId=1&articleId=5105797&isAgree=1
HTTP请求方式：POST
是否需要登录：否
返回格式：json
缓存方式：无
缓存时间：无
请求参数：
    act：请求动作，delOrAddArtAgree为顶、踩文章和取消顶、踩文章动作
    siteId:主网站id，电脑网为1
    articleId：文章id
    isAgree：1表示“顶/取消顶”；2表示“踩/取消踩”

返回结果：
  {"code":0,"message":"用户赞、踩文章成功"}
  {"code":-1,"message":"文章不存在"}
  如果isAgree为空
  {"code":-1,"message":"缺少isAgree参数"}

  如果用户未登录：
  {"code":1,"message":"该IP用户取消赞成功"}
  {"code":2,"message":"该IP用户取消踩成功"}
  {"code":3,"message":"该文章已被该IP用户赞过"}
  {"code":4,"message":"该文章已被该IP用户踩过"}
  如果用户已经登录：
  {"code":1,"message":"该用户取消赞成功"}
  {"code":2,"message":"该用户取消踩成功"}
  {"code":3,"message":"该文章已被该用户赞过"}
  {"code":4,"message":"该文章已被该用户踩过"}
结果说明：
  调用该接口进行赞和踩操作，对于未赞，踩的文章进行执行赞，踩，对于已被赞，踩的文章进行取消赞，取消踩，对于已赞的文章不能进行踩/取消踩操作，对于已踩的文章不能进行赞/取消赞操作

}}}

=== 2.4 [=#point204 图赏 - 推荐图集] ===
{{{
 备注：滚动到图集最后一张图后显示推荐图集
 请求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": "图集标题"
   },
   {
     "id": 130583,//图集id
     "image": "http://i3.3conline.com/images/piclib/201305/23/batch/1/176477/1369277363528pbshbw5puy_medium.jpg",//图集封面图，尺寸待定
     "photoCount": "10",//图片数
     "title": "图集标题"
   },
   {
     "id": 130583,//图集id
     "image": "http://i3.3conline.com/images/piclib/201305/23/batch/1/176477/1369277363528pbshbw5puy_medium.jpg",//图集封面图，尺寸待定
     "photoCount": "10",//图片数
     "title": "图集标题"
   }
 ]
}}}

=== 2.5 [=#point205 个人中心 - 用户信息] ===
{{{
 备注：个人中心，登录之后的用户信息
 请求URL:http://mrobot.pconline.com.cn/v3/itbbs/getUserInfo
 HTTP请求方式：get
 是否需要登录：是
 返回格式：json
 缓存方式：无
 缓存时间：无
 请求参数：
        uid：用户ID,如果没有此参数则返回当前用户信息
 返回参数：
        {
            "image":头像
            "level":用户级别
            "name":用户名
            "nickname":用户昵称
            "userId":用户ID
            "friends":关注好友数
            "fans":粉丝数,
            //以下信息本人登陆才返回
            "birthday":983462400000,
            "sex":1,//0未知 1男 2女
            "cityId":370100,
            "cityName":"济南市",
            "provinceName":"山东省",
            "phoneNum":"",
            "address":"",
            "zipCode":"",
            "realName":""
        }
}}}

=== 2.6 [=#point206 个人中心 - 获取粉丝、关注列表] ===
{{{
 备注：返回包括粉丝、关注列表
 请求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.7 [=#point207 个人中心 - 收到的私信列表、发出的私信列表] ===
{{{
 备注：收到的私信列表、发出的私信列表
 请求URL：http://mrobot.pconline.com.cn/v3/bbs/getMessageList?type=1&common_session_id=6E2073035FC49C29DD038821CAF2058F93196617DE299753&resp_enc=UTF-8&siteId=2&status=-1&pageNo=1&pageSize=20&req_enc=UTF-8
 HTTP请求方式：get
 是否需要登录：是
 返回格式：json
 缓存方式：无
 缓存时间：无
 请求参数：
        type：私信类型（1 收到的私信； 0 发出的私信）
        siteId：网站ID（1是电脑网，2是汽车网，3是游戏网，4是女性网，5是亲子网，6是家居网）
        status：私信状态(-1为已读和未读，0表示未读，1表示已读)
        pageNo：页码
        pageSize：一页条数，默认20，最大500
        common_session_id
        req_enc：UTF-8
        resp_enc：UTF-8
 返回参数：
        {
            total: 总的条数
            pageNo: 页码
            pageCount: 页数
            pageSize: 每页条数
            resultList:{
                        id: 消息ID
                        content: 消息内容
                        createTime: 发送时间
                        status: 阅读状态
                        accountId: 用户ID
                        senderId: 发送者ID
                        receiverNickname:发送者昵称
                        receiverFace:头像
                        replyId: 回复ID
                        showStatus: 显示状态
                    }
        }
}}}

=== 2.8 [=#point208 个人中心 - 发私信、回复私信接口] ===
{{{
  备注：发私信、回复私信接口
 请求URL:http://bip.pconline.com.cn/intf/message.jsp
 HTTP请求方式：post
 是否需要登录：是
 返回格式：json
 缓存方式：无
 缓存时间：无
 请求参数：
        accountId：用户ID
        act=create
        accountId:发送给某个用户
        content:消息内容
        captcha:验证码
        req_enc：UTF-8
        resp_enc：UTF-8
 (说明：发送限制)
 1.post
 2.验证码
 3.黑名单
 4.邮箱绑定,该限制仅限於2012-01-01起注册的用户
 5.发送频率 50次/ID/24H
 6.白名单最多一次发送50个用户，非白名单则每次只能发一个
 7.添加关键词库过滤
 返回参数：
        {code:0,message:"提示"}
}}}

=== 2.9 [=#point209 个人中心 - 修改昵称] ===
{{{
  备注：修改昵称
 请求URL：http://my.pconline.com.cn/intf/syncNickName.jsp
 HTTP请求方式：post
 是否需要登录：是
 返回格式：json
 缓存方式：无
 缓存时间：无
 请求参数：
        req_enc：UTF-8
        resp_enc：UTF-8
        nickName：昵称
        act：save
 
 返回参数：
        {"code":0}表示成功, {"code":非0,"message":"提示"}
}}}

=== 2.10 [=#point210 个人中心 - 修改头像] ===
{{{
  备注：修改头像
 请求URL：http://upc.pconline.com.cn/upload_head.jsp
 HTTP请求方式：post
 是否需要登录：是
 返回格式：json
 缓存方式：禁用缓存
 缓存时间：无
 请求参数：
        二进制图片数据
 返回参数：
        成功：{retCode: 0} 失败：{retCode: xxx}
}}}

=== 2.11 [=#point211 个人中心 - 关注、取消关注] ===
{{{
 备注：关注、取消关注
 请求URL：http://m.pconline.com.cn/bip/intf/focus.jsp
 HTTP请求方式：post
 是否需要登录：是
 返回格式：json
 缓存方式：无
 缓存时间：无
 请求参数：
        act=add|delete(add:关注,delete:取消关注)
        accountId=xxxxxx 当前用户ID
        friendId=xxxxxx 关注用户ID
        req_enc：UTF-8
        resp_enc：UTF-8
        common_session_id
 返回参数：
        {"code":0}成功
}}}

=== 2.12 [=#point212 个人中心 - 判断与某用户的关系(关注与非关注)] ===
{{{
 备注：判断与某用户的关系
 请求URL：http://m.pconline.com.cn/bip/intf/focus.jsp
 HTTP请求方式：get
 是否需要登录：是
 返回格式：json
 缓存方式：无
 缓存时间：无
 请求参数：
        act=isHisFocus
        accountId=xxxxxx 当前用户ID
        friendId=xxxxxx 关注用户ID
        req_enc：UTF-8
        resp_enc：UTF-8
        common_session_id
 返回参数：
        0:没关注,1:关注,2:被关注,3:相互关注
}}}

=== 2.13 [=#point213 个人中心 - 他人主页] ===
{{{
 备注：获取他人最新动态接口
 请求URL：http://mrobot.pconline.com.cn/v3/bbs/newsfeed/{用户ID}
 HTTP请求方式：get
 是否需要登录：是
 返回格式：html页面
 缓存方式：无
 缓存时间：无
 请求参数：
        UID:用户ID
}}}

=== 2.14 [=#point214 个人中心 - 最新消息数] ===
{{{
 备注：最新消息数接口，增加新的私信消息数
 请求URL：http://mrobot.pconline.com.cn/v3/itbbs/getNewMsgCount?accountId=31356890
 HTTP请求方式：get
 是否需要登录：是
 返回格式：json
 缓存方式：无
 缓存时间：无
 请求参数：
        accountId:用户ID
}}}

=== 2.15 [=#point215 个人中心 - 推广位列表] ===
{{{
 备注：返回推广位列表；uri参数部分需要按百分号转义
 请求URL：http://mrobot.pconline.com.cn/v2/cms/proxy?uri=http://app.pconline.com.cn/appnews/tghd/1403/intf4501.js
 HTTP请求方式：get
 是否需要登录：是
 返回格式：json
 缓存方式：无
 缓存时间：无
 请求参数：
        uri：被代理的原始接口
 返回结果：
        {
            data:[
                {
                    "title": "元旦刮卡抽399元智能水杯",
                    "to-uri": "http://play10.pconline.com.cn/online141226/index.jsp?fromapp=1"
                },
                {
                    "title": "元旦刮卡抽399元智能水杯",
                    "to-uri": "http://play10.pconline.com.cn/online141226/index.jsp?fromapp=1"
                },
                {
                    "title": "元旦刮卡抽399元智能水杯",
                    "to-uri": "http://play10.pconline.com.cn/online141226/index.jsp?fromapp=1"
                }
            ]
        }
}}}

=== 2.16 [=#point2.16 搜索 - 综合搜索] ===
{{{
备注:返回结果包括相关产品、相关文章、相关帖子；具体规则参考web版综合搜索
返回结果说明:
相关产品：有则返回，没有则为空，服务器可先过滤，最多返回1条数据给客户端；
相关文章：按照目前的web规则，是搜索评测的相关文章，具体规则可以问问快搜接口的同事；返回数据，有则返回，没有则为空，服务器可先过滤，最多返回3条数据给客户端；
相关帖子：处理方式同文章；服务器可先过滤，最多返回3条数据给客户端。

请求url:http://mrobot.pconline.com.cn/v3/search/composite?keyword=华为
HTTP请求方式:GET
是否需要登录:false
返回格式:JSON
缓存方式:对象缓存
缓存时间:1分钟
请求参数:
  keyword：搜索的关键词
返回结果:
{
  "productList": [
    {
      "id": "559363",
      "pic": "http://img.pconline.com.cn/images/product/5593/559363/z_sn7.jpg",
      "price": 798.0,
      "summary": "2G/3G网络:GSM,TD-SCDMA(移动3G),双卡双待 | 主屏尺寸:5.0英寸 | 屏幕分辨率:1280×720像素(720P) | 系统:Android 4.2 | 电池容量:可更换,2300mAH | CPU:MT6582 1.3GHz(4核)",
      "title": "华为 荣耀3C移动3G版/1GB RAM"
    },
    {
      "id": "557535",
      "pic": "http://img.pconline.com.cn/images/product/5575/557535/q_sn7.jpg",
      "price": 1099.0,
      "summary": "2G/3G网络:GSM,WCDMA(联通3G),TD-SCDMA(移动3G),双卡双待 | 主屏尺寸:5.5英寸 | 屏幕分辨率:1280×720像素(720P) | 系统:Android 4.2 | 电池容量:3000mAH | CPU:MT6592 1.7GHz(8核)",
      "title": "华为 荣耀3X(G750)"
    }
  ],
  "articleList": [
    {
      "id": "5941716",
      "pubDate": "2014-12-29",
      "title": "先于华为！高通810芯片Cat 9基带附体",
      "url": "http://pad.pconline.com.cn/594/5941716.html"
    },
    {
      "id": "5926456",
      "pubDate": "2014-12-25",
      "title": "华为新款旗舰P8曝光 配置飙升指纹前置",
      "url": "http://mobile.pconline.com.cn/592/5926456.html"
    }
  ],
  "topicList": [
    {
      "access": "6",
      "authorId": "4177236",
      "createAt": 1420388222000,
      "flag": "",
      "forumId": 240027,
      "replycount": "6",
      "title": "华为 Mate7 曜石黑 移动版，仅开封，带票皮套",
      "topicId": 51994488,
      "userName": "jccong"
    },
    {
      "access": "0",
      "authorId": "26654840",
      "createAt": 1420429064000,
      "flag": "",
      "forumId": 587012,
      "replycount": "0",
      "title": "【我有我自·在】华为Ascend G7伴我圣诞购物行②强悍性能",
      "topicId": 51995084,
      "userName": "余闻星堕地"
    }
  ],
}
}}}

== 3.协议说明 ==
=== 3.1 [=#point301 文章页跳转评论页协议] ===
{{{
协议名：pconlinebrowser://comment/{评论id}
参数：评论id：该文章的评论id,无法获取时，传-1；另外，客户端目前不需要评论id
备注：此协议在4.0.0版本中的有效范围：文章页
}}}

=== 3.2 [=#point302 跳转至他人主页协议] ===
{{{
协议名：pconlinebrowser://user-center/{用户id}
参数：用户id：用户的通行证id，必填字段
备注：此协议在4.0.0版本中的有效范围：帖子页、他人主页中的动态页
}}}

=== 3.3 [=#point303 产品详情页跳转至对比页协议] ===
{{{
协议名：pconlinebrowser://product-compare-param/{产品id}
参数：产品id：当前产品的id，必填字段
备注：此协议在4.0.0版本中的有效范围：产品详情概述页
}}}