wiki:pconline_4.1.0/interface

Version 10 (modified by wuchangbo, 11 years ago) (diff)

--

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

 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 个人中心 - 验证码接口

   URL:http://captcha.pconline.com.cn/captcha/v.jpg
       请求方式:HTTP GET
       说明:获取用户验证码

2.3 首页 - 栏目列表

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后缀来判断是否显示跳转到浏览器的按钮

3.2 聚超值跳转到登录界面协议

协议名:pcaction://user-browser-user-center?callback=
例如:  <a href='pcaction://user-browser-user-center?callback='>登录</a>
备注:  登陆成功后客户端会把用户的sessionId存放到cookie里,wap端需自行获取对应的字段。对应的字段名为:common_session_id