wiki:pconline_4.1.0/interface

Version 24 (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:https://passport3.pchouse.com.cn/passport3/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"]
 ]
}

2.4 首页 - 图赏

   URL:http://mrobot.pconline.com.cn/v2/cms/channels/{栏目ID}?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                                                                                                //总数
       }

2.5 聚超值wap页面

   请求方式:HTTP GET
   说明:所有wap页面需要在URL后面添置fromapp=以便服务端判断用户是使用app登录还是直接浏览器登录,同时因为需要在wap端做第三方商城跳转计数器,android端需要在每个URL后面带上dev_id,IOS端需要加dev_id与open_udid
   例如:http://g.pconline.com.cn/best/haitao/133476.html?fromapp=&dev_id=***&open_udid=***
   聚超值对应的五个WAP页面为:
   http://g.pconline.com.cn/best/infoapp/discovery.jsp     发现
   http://g.pconline.com.cn/best/infoapp/index.jsp         最新
   http://g.pconline.com.cn/best/infoapp/experience.jsp    经验
   http://g.pconline.com.cn/best/infoapp/haitao.jsp        海淘
   http://g.pconline.com.cn/best/infoapp/shaiwu.jsp        晒物

3.协议说明

3.1 聚超值跳转去看看协议

备注:此协议在4.1.0版本中的有效,客户端根据http://g.pconline.com.cn/best/域名来判断是否显示跳转到浏览器的按钮

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

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

3.3 聚超值计数器

说明:电脑网聚超值wap页面需要对跳转到第三方平台事件做计数,因为调用计数器接口需要用到dev_id与openudid(IOS特有),所以需要客户端这边通过get的方式传到wap端。
实现原理是在所有的聚超值URL后面加上dev_id(IOS是dev_id和open_udid),例如:http://g.pconline.com.cn/best/haitao/?dev_id=****&open_udid=***

3.4 产品详情计数器

说明:电脑网产品库的产品详情wap页面需要对跳转到第三方平台事件做计数,因为调用计数器接口需要用到dev_id与openudid(IOS特有),所以需要客户端这边通过get的方式传到wap端。
实现原理是在所有的详情URL后面加上dev_id(IOS是dev_id和open_udid)
例如:http://mrobot.pconline.com.cn/v3/product/summary/575971?ver=33&appVersion=4.1.0&dev_id=***&open_udid=***