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端做第三方商城跳转计数器,android端需要在每个URL后面带上dev_id,IOS端需要加dev_id与open_udid
例如:http://g.pconline.com.cn/best/haitao/133476.html?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=***