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 头像以及昵称修改
修改昵称
接口URL:http://my.pcauto.com.cn/intf/syncNickName.jsp
必填参数:
act:save
nickName:昵称
提交方式:POST
是否需要登录:是
返回格式:json
缓存方式:无
缓存时间:无
返回结果:{"code":0}表示成功, {"code":非0,"message":"提示"}
修改头像
接口URL:http://upc.pcauto.com.cn/upload_head.jsp
必填参数:
二进制图片数据
提交方式:POST
是否需要登录:是
返回格式:json
缓存方式:无
缓存时间:无
返回结果: 成功:{retCode: 0} 失败:{retCode: xxx}
2.2 获取用户信息
接口URL:http://mrobot.pcauto.com.cn/v3/bbs/getUserInfo
参数:
uid:用户ID,如果没有次参数则返回当前用户信息
提交方式:GET
是否需要登录:是
返回格式:json
缓存方式:无
缓存时间:无
返回结果:
{
"image":头像
"isVip":是否认证车主
"level":用户级别
"name":用户名
"nickname":用户昵称
"serialId":认证车系ID
"serialName":认证车系名
"userId":用户ID
"friends":关注好友数
"fans":粉丝数
}
2.3 验证码和发私信
验证码接口
接口URL:http://captcha.pcauto.com.cn/captcha/v.jpg
无参数
返回一张验证码图片
发私信接口
接口URL:http://bip.pcauto.com.cn/intf/message.jsp?act=create
必填参数:
accountId:发送给某个用户
content:消息内容
captcha:验证码
/*
* 发送限制 add by handy 2012.04.01
* 1.post 2.验证码 3.黑名单
* 4.邮箱绑定,该限制仅限於2012-01-01起注册的用户 edit by handy 2012.04.10
* 5.发送频率 50次/ID/24H
* 6.白名单最多一次发送50个用户,非白名单则每次只能发一个 7.添加关键词库过滤
*/
提交方式:POST
是否需要登录:是
返回格式:json
缓存方式:无
缓存时间:无
结果返回
{code:0,message:"提示"}
2.4 我的论坛接口
接口URL:http://mrobot.pcauto.com.cn/v3/bbs/myTopics/{UID:用户ID}
参数
filter:post|pick(post:回帖,pick:精华贴),缺省参数为主贴
pageNo=页码
pageSize=一页条数,默认20,最大500
maxLength=50内容截取长度
提交方式:POST
是否需要登录:是
返回格式:json
缓存方式:无
缓存时间:无
结果返回:
{
"total":18,
"pageNo":1,
"pageSize":20,
"topicList":[
{
"flag":"图",//主贴标识
"forumName":"北京分会",//论坛名字
"replyCount":70,//主贴回复数
"title":"妞开妞车---和我的小七一起臭美一下",//主贴标题
"topicId":3840024,//主贴ID
"updateAt":1382084688000,更新时间
"view":43267//主贴阅读数
"content":"{顶}{顶}{顶}",//回帖内容(filter:post)
"topicAuthorId":"28087017",//主贴作者ID(filter:post)
"topicAuthorNickName":"北京大妞儿",//主贴作者昵称(filter:post)
}
]
}
2.5 我的收藏夹论坛列表
接口URL:http://bbs.pcauto.com.cn/intf/user/_favForums.jsp
必填参数:
userId:用户ID
提交方式:POST
是否需要登录:是
返回格式:json
缓存方式:无
缓存时间:无
结果返回:
{
"listCount":2,
"list":[
{
"banzhuList":[
{
"userId":25508566,
"userName":"牛仔bu忙",
"userNickName":"牛仔",
"userUrl":"http://my.pcauto.com.cn/25508566"
}
],
"favoriteId":134760,
"forumIcon":"",
"forumId":18976,
"name":"最汽车主版",
"url":"http://bbs.pcauto.com.cn/forum-18976.html"
}
]
}
2.6 获取用户评论列表
接口URL:http://mrobot.pcauto.com.cn/v3/cmt/userCmtList/{UID}
必填参数:
UID:用户ID
webSite:pcauto
提交方式:GET
是否需要登录:是
返回格式:json
缓存方式:无
缓存时间:无
结果返回:
{
"total":18,
"uid":8749870,
"status":0,
"pageNo":1,
"pageSize":20,
"data":[
{
"content":"烂马6",
"id":26631960,
"articleId":3819521,
"createTime":1391850176000,
"topicTitle":"最高降幅5.4万 10款主流B级车迎新春促销",
"topicUrl":"http://www.pcauto.com.cn/qcbj/381/3819521.html",
"floor":58,
"status":2,
"nickname":"小星星",
"replyRef":{
"content":"认了他就老老实实喊教练,要不当初你就不要让他教。发这种言论,你俩不愧是狗教的",
"uid":0,
"id":26269691,
"createTime":1384150537000,
"floor":21,
"status":2,
"nickname":"浙江省嘉兴市网友",
"replyRef":{
},
"ip":"192.168.239.90-115.230.213.159"
},
"topicId":13107080,
"url":"http://cmt.pcauto.com.cn/topic/a0/r0/p1/ps20/t13107080.html",
"ip":"192.168.239.108-14.23.114.34"
}
]
}
2.7 获取用户的好友列表
返回包括关注的好友和粉丝
接口URL:http://my.pcauto.com.cn/intf/app/focus.jsp
参数:
accountId=用户ID,如果没有改参数的话则返回当前用户的好友列表
act=findFocus为关注,findFocusBy为粉丝
pageNo=页码
pageSize=页长度
提交方式:GET
是否需要登录:是
返回格式:json
缓存方式:无
缓存时间:无
返回
{
"total":18,
"pageCount":2,
"pageNo":1,
"pageSize":20,
"resultList":[
{
"accountId":用户ID
"focusNum":关注好友数
"fanNum":粉丝数
"nickName":用户昵称
"image":头像
}
]
}
2.8 收到的私信列表
接口URL: http://mrobot.pcauto.com.cn/v3/bbs/getMessageList
必填参数:
type=1
siteId=网站ID(1是电脑网,2是汽车网,3是游戏网,4是女性网,5是亲子网,6是家居网)
status=-1(-1为已读和未读,0表示未读,1表示已读)
非必要参数:
pageNo=页码
pageSize=一页条数,默认20,最大500
是否需要登录:是
返回格式:json
支持跨域:是
支持回调:是
缓存方式:无
缓存时间:无
返回结果:
{
total: 总的条数
pageNo: 页码
pageCount: 页数
pageSize: 每页条数
resultList:{
id: 消息ID
content: 消息内容
createTime: 发送时间
status: 阅读状态
accountId: 用户ID
senderId: 发送者ID
receiverNickname:发送者昵称
receiverFace:头像
replyId: 回复ID
showStatus: 显示状态
}
}
2.9 发出的私信列表
接口URL:http://mrobot.pcauto.com.cn/v3/bbs/getMessageList
必填参数:
type=0
siteId=网站ID(1是电脑网,2是汽车网,3是游戏网,4是女性网,5是亲子网,6是家居网)
status=-1(-1为已读和未读,0表示未读,1表示已读)
非必要参数:
pageNo=页码
pageSize=一页条数,默认20,最大500
是否需要登录:是
返回格式:json
支持跨域:是
支持回调:是
缓存方式:无
缓存时间:无
返回结果:
{
total: 总的条数
pageNo: 页码
pageCount: 页数
pageSize: 每页条数
resultList:{
id: 消息ID
content: 消息内容
createTime: 发送时间
accountId: 用户ID
receiverIds: 发送者ID
receiverId: 发送者ID
receiverNickname:发送者昵称
userhead:头像
}
}
2.10 获取系统消息接口&清零系统消息
获取系统消息
接口URL:http://bip.pcauto.com.cn/intf/sysnotice.jsp
必填参数:
act=find
siteId=网站ID(1是电脑网,2是汽车网,3是游戏网,4是女性网,5是亲子网,6是家居网)
status=-1(-1为已读和未读,0表示未读,1表示已读)
typeIds=2004
非必要参数:
groupType=消息分组,默认全部,开发人员提供
status=0是未读,1是已读,默认-1是全部
startDate=开始时间
endDate=结束时间
beforeDay=在某个时间前
pageNo=页码
pageSize=一页条数,默认20,最大500
noTemplate=true不需要模板,false需要模板,默认是false
是否需要登录:是
返回格式:json
支持跨域:是
支持回调:是
缓存方式:无
缓存时间:无
返回结果:
{
total: 总的条数
pageNo: 页码
pageCount: 页数
pageSize: 每页条数
resultList:{
id: 消息ID
type: { //消息类型
name: 消息类型名称
id: 消息分类ID
description: 描述
siteId: 网站ID
templateId: 模板ID
groupType: 分组ID
}
content: 模板内容
createTime: 发送消息时间戳
status: 状态
accountId: 接收消息人
siteId: 网站ID
typeId: 分类ID
senderId: 发送者ID
groupSend: 是否群发
groupType: 消息分组
resultText: 操作结果
}
清零系统消息
接口URL:http://mrobot.pcauto.com.cn/v3/bbs/setNewMsgState
参数:
messageType=1
typeIds=2004
提交方式:POST
2.11 收集推送token接口
token数据放在passport2,赖子粼负责
接口URL:http://passport2.pconline.com.cn/passport2/api/mobilePushInfo.jsp
必填参数:
act=addMobilePushInfo
deviceType=1//设备类型,1:iOS,2:android
token=xxx//推送token
提交方式:POST
是否需要登录:是
返回格式:json
支持跨域:是
支持回调:是
缓存方式:无
缓存时间:无
返回
{"code":0,"message":"数据已经插入"}
接口是否已经完善:测试环境
2.12 获取他人信息接口
参照2.2
2.13 获取他人最新动态接口
接口URL:http://mrobot.pcauto.com.cn/v3/bbs/newsfeed/{UID}|{?night}
参数:
UID:用户ID
?night:夜间模式
返回:
html页面
2.14 获取他人帖子列表
参照2.4
2.15 获取他人评论列表
参照2.6
2.16 获取爱车列表
接口URL:http://my.pcauto.com.cn/intf/getCars.jsp
参数
act{
=getCars 获取该用户所有爱车;
=getCarSeries获取该用户的添加的车型;
=getCarModels获取该用户的添加的车系;
}
accountId = (不传此参数,将获取登录ID,);
pageNo = (次参数不传,则为默认为1,即第一页);
pageSize = (次参数不传,则为默认为20,最小为1,最大为100);
callback = (回调函数)
返回值:
失败:{"code":-1,"message":""}
成功:[
{
"createTime":"2013-11-28 08:24:21",
"accountId":8749870,
"carSeriesId":4580,
"carModelId":0,
"updateTime":"2013-11-28 08:24:21",
"carPic":"http://img.pconline.com.cn/images/upload/upc/tx/auto5/1311/17/c2/28719139_1384678383261_270x202.jpg",
"brandId":932,
"buyPlaceId":0,
"id":270094,
"driveStatus":0,
"buyPlace":null,
"name":"残缺的F5",
"brand":" 长城汽车 ",
"carSeriesName":"哈弗H6"
}
]
注意:
用户须登录;
调用接口时需把common_session_id传过来;
因为act=getCars是旧接口,不能改动,所以没有做任何改变,没有分页,act=getCarSeries, act=getCarModels是新接口,可传分页参数,新旧接口返回json结构不一样。
2.17 获取他人好友列表
参照2.7
2.18 关注&取消关注
接口URL:http://m.pcauto.com.cn/bip/intf/focus.jsp
必填参数:
act=add|delete(add:关注,delete:取消关注)
accountId=xxxxxx 当前用户ID
friendId=xxxxxx 关注用户ID
是否需要登录:是
返回格式:json
支持跨域:是
支持回调:是
缓存方式:无
缓存时间:无
返回:
{"code":0}成功
判断与某用户的关系
act=isHisFocus
accountId=xxxxxx 当前用户ID
friendId=xxxxxx 关注用户ID
返回:0:没关注,1:关注,2:被关注,3:相互关注
2.19 精准选车-车系列表接口
接口URL:http://mrobot.pcauto.com.cn/v2/price/models/search
必填参数:
queryJson:查询条件
type=1
是否需要登录:否
返回格式:json
支持跨域:是
支持回调:是
缓存方式:无
缓存时间:无
返回结果:
{
"data":[
{
"displacement":"1.3",
"gearbox":"5档手动",
"horsePower":"88",
"id":"24000",
"kind":"中型SUV",
"lowestPrice":"4.78万",
"photo":"",
"price":"47800",
"serialId":"4207",
"serialName":"野马F99",
"size":"4510x1720x1630",
"title":"野马F99 2012款 1.3L 两驱 手动基本型"
}
],
"pageCount":1,
"pageNo":1,
"pageSize":1000,
"total":347
}
2.20 车型库-品牌列表
接口URL:http://mrobot.pcauto.com.cn/v2/price/brands
请求方式:get
是否需要登录:否
请求参数:无
2.21 车系图片列表-部分
接口URL:http://mrobot.pcauto.com.cn/v2/price/pictures
请求方式:get
是否需要登录:否
请求参数:
serialGroupId:车系id
fmt:返回格式
typeId:部件,1为外观,2为内饰,3为其他细节,4为官方图
2.22 推荐图集
备注:滚动到图集最后一张图后显示推荐图集,使用范围:汽车网app
请求URL:http://mrobot.pcauto.com.cn/v2/photo/recommendAlbums
HTTP请求方式:get
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:无
请求参数:无返回参数:
[
{
"id":130583, // 图集id
"image":"http://i3.3conline.com/images/piclib/201305/23/batch/1/176477/1369277363528pbshbw5puy_medium.jpg", // 图集封面图,尺寸待定
"photoCount":"10",//图片数
"title":"图集标题"
}
]