[[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 个人中心 - 登陆接口] ===
{{{

 URI：/rest/login.jsp
        请求方式：HTTPS POST
        说明：用户登录接口
	参数：
	  1). username ：用户名
	  2). password ：密码
	  3). captcha ：验证码（密码错误大于等于3次需要输入验证码）
             （验证码图片请求时会回设cookie：captcha，表单提交的时候带回cookie才能校验通过）
          4). auto_login：cookie过期时间，不填默认为15天，最大不超过90天
	返回(json格式)：
            失败：
            {"status":" + ex.getStatus() + ","message":""+ ex.getMessage() + ""}
            成功：
            {"status":0,"message":"ok","session":"abcdefghijk","userId":"123456 ","common_session_id":"abcdefghijk"}
	   说明：
               status : 处理状态(0 为成功,其他为失败)
	       message : 相关状态信息
	       session : common_session_id值
	       common_session_id : common_session_id值
	       userId: 当前登录用户id
}}}

=== 2.2 [=#point202 个人中心 - 验证码接口] ===
{{{
   URL:http://captcha.pconline.com.cn/captcha/v.jpg
       请求方式：HTTP GET
       说明：获取用户验证码
}}}

=== 2.3 [=#point203 首页 - 栏目列表] ===
{{{
Android: http://mrobot.pconline.com.cn/configs/pconline_v6_cms_android_channel_tree
       请求方式：HTTP GET
       说明：获取栏目列表(新增图赏栏目,放在news对象第六位)
       android图赏tab：858,   ios图赏tab：859
       返回(json格式)
       {
 "news":
  [
      ["999","头条", "528"], 
      ["2","新闻", "530"],
      ["4","评测", "532"],
      ["10","直播", "531"],
      ["200", "手机", "533"],
      [ "0","图赏","858"],
      ["120", "DIY", "540"],
      ["100000", "行情", "536"],
      ["3","导购", "535"],
      ["300", "笔记本", "537"],
      ["301", "超极本", "534"],
      ["400", "平板", "538"],
      ["500", "相机", "539"],
      ["600", "家电", "541"],
      ["700", "MID", "542"],
      ["800", "摄像机", "543"],
      ["130", "企业", "545"],
      ["900", "电视", "544"],
      ["1000", "软件", "721"]
  ],
  "events":
  [],
 "product":
  [],
 "area":
  [
      ["100000", "全国", "6978"],
      ["110000", "北京", "6978"],
      ["310000", "上海", "6978"],
      ["440100", "广州", "6978"],
      ["440300", "深圳", "6978"],
      ["500000", "重庆", "6978"],
      ["210000", "辽宁", "6978"],
      ["350000", "福建", "6978"],
      ["330000", "浙江", "6978"],
      ["450000", "广西", "6978"],
      ["510100", "成都", "6978"],
      ["420100", "武汉", "6978"],
      ["120105", "河北", "6978"],
      ["230000", "黑龙江", "6978"],
      ["220403", "西安", "6978"],
      ["370000", "山东", "6978"],
      ["430000", "湖南", "6978"],
      ["410000", "河南", "6978"],
      ["360000", "江西", "6978"],
      ["810000", "香港", "6978"],
      ["440400", "珠海", "6978"],
      ["340000", "安徽", "6978"],
      ["460000", "海南", "6978"],
      ["320000", "江苏", "6978"],
      ["441900", "东莞", "6978"],
      ["120000", "天津", "6978"],
      ["330200", "宁波", "6978"],
      ["440600", "佛山", "6978"],
      ["210200", "大连", "6978"],
      ["130600", "保定", "6978"],
      ["441700", "阳江", "6621"]
 ]
}
}}}

=== 2.4 [=#point204 首页 - 图赏] ===
{{{
   URL:http://mrobot.pconline.com.cn/v2/cms/channels/11?pageSize=5&pageNo=1
       请求方式：HTTP GET
       说明：获取用户验证码
       参数：
	  1). pageSize：页面大小
	  2). pageNo：  当前页码
       返回(json格式)
       {
            "groups": [            //图集数组
            {
                 "cover": "http://img.pconline.com.cn/images/piclib/201403/11/simple/1/13945097409755921uzbi90.jpg",     //封面
                 "id": 12219,                                                                                            //图集ID
                 "name": "【人像】A quiet",                                                                              //名字
                 "photoCount": 11                                                                                        //图集ID
            },
            {
                 "cover": "http://img.pconline.com.cn/images/upload/upc/tx/onlinephotolib/1503/01/c0/3373139_1425206827506.jpg",
                 "id": 14072,
                 "name": "双玻璃面板 三星GALAXY S6现场图赏",
                 "photoCount": 13
            },
            {
                 "cover": "http://img.pconline.com.cn/images/upload/upc/tx/onlinephotolib/1504/29/c0/6097294_1430241103137.jpg",
                 "id": 14346,
                 "name": "LG G4试玩图赏:这些机身元素都好少见",
                 "photoCount": 24
            }
            ],
            "pageNo": 1,                                                                                              //当前页码
            "pageSize": 5,                                                                                            //页面大小
            "total": 3                                                                                                //总数
       }
}}}



== 3.协议说明 ==
=== 3.1 [=#point301 聚超值跳转去看看协议] ===
{{{
备注：此协议在4.1.0版本中的有效,客户端根据http://g.pconline.com.cn/best/域名来判断是否显示跳转到浏览器的按钮
}}}
=== 3.2 [=#point301 聚超值跳转到登录界面协议] ===
{{{
协议名：pcaction://user-browser-user-center?callback=
例如：  <a href='pcaction://user-browser-user-center?callback='>登录</a>
备注：  登陆成功后客户端会把用户的sessionId存放到cookie里，wap端需自行获取对应的字段。对应的字段名为：common_session_id
}}}