[[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"]
 ]
}

3.协议说明

3.1 聚超值跳转去看看协议

协议名：{url}#gotosee
例如：  http://g.pconline.com.cn/best/load.jsp?topicId=130503#gotosee
备注：此协议在4.1.0版本中的有效,客户端根据是否有gotosee后缀来判断是否显示跳转到浏览器的按钮

}}}