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 图集
备注:根据分类id请求图集列表(汽车网)
请求URL:http://agent1.pconline.com.cn:8941/pcautophoto/iphone_cate_json.jsp?id=85
HTTP请求方式:get
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
id:图集类别id
2.2 图集列表
备注:图集列表
请求URL:http://mrobot.pcauto.com.cn/v2/photo/albums?modelId=8840
HTTP请求方式:get
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
modelId:车型id
2.3 推荐图集
备注:滚动到图集最后一张图后显示推荐图集,使用范围:汽车网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": "图集标题"
}
]
2.4 伪造顶踩数
备注:伪造顶踩数
请求URL:http://mrobot.pcauto.com.cn/v3/bbs/hot?pageNo=1&pageSize=20
HTTP请求方式:get
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
pageNo:页码
pageSize:一页条数
2.5 帖子列表
备注:获取帖子列表,在原来的基础上添加置顶数据。置顶数据包含全站置顶和本版置顶。
置顶数据不给出所有置顶帖,只是分别从两者随机抽取一条数据出到接口,该数据flag字段的值恒为“荐”。
请求URL:http://mrobot.pcauto.com.cn/v3/bbs/newForums/19139?pageNo=1&pageSize=19&orderby=postat
HTTP请求方式:get
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
论坛ID
pageNo:页码
pageSize:一页条数
orderby=postat:最新帖,orderby=replyat:最热帖,filter=pick:精华帖
2.6 帖子终端页
备注:获取文章或者帖子内容
请求URL:http://mrobot.pcauto.com.cn/v2/bbs/topics/4592911?pageNo=1&pageSize=19&picRule=2&authorId=0&topicTemplate=4.0.0&app=pcautobrowser&size=18
HTTP请求方式:get
是否需要登录:否
返回格式:html页面
缓存方式:无
缓存时间:无
请求参数:
帖子ID
pageNo:页码
pageSize:一页条数
picRule:获取图片的网络访问方式
authorId:作者ID
topicTemplate=4.0.0
app=pcautobrowser
size:字体大小
mode:阅读模式:无参数 白天;night 晚间
2.7 论坛搜索
备注:论坛搜索
请求URL:http://mrobot.pcauto.com.cn/v3/bbs/search?q=%E4%BA%BA&pageNo=9&pageSize=2
HTTP请求方式:get
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
q:搜索关键字
pageNo:页码
pageSize:每页行数
2.8 车型库首页热门车系列表&您可能对以下内容感兴趣
备注:1、车型库首页热门车系; 2、获取可能感兴趣内容
请求URL:http://mrobot.pcauto.com.cn/configs/pcauto_hot_serials
HTTP请求方式:get
是否需要登录:是
返回格式:json
缓存方式:无
缓存时间:无
请求参数:无
2.9 车型库品牌列表
备注:获取车型库品牌列表
请求URL:http://mrobot.pcauto.com.cn/v2/price/brands
HTTP请求方式:get
是否需要登录:否
返回格式:json
缓存方式:
缓存时间:
请求参数:无
2.10 通过品牌ID得到车系列表
备注:通过品牌ID得到车系列表
请求URL:http://mrobot.pcauto.com.cn/v3/price/getSerialListByBrandId/60
HTTP请求方式:get
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
品牌id
2.11 厂商车系列表
备注:根据厂商id返回该厂商所属品牌的车系列表
请求URL:http://mrobot.pcauto.com.cn/v3/price/getSerialListByManufacturerId/37
HTTP请求方式:get
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
厂商id
2.12 车型列表
备注:车型列表
请求URL:http://mrobot.pcauto.com.cn/v3/price/getModelListBySerialId_v4/3524
HTTP请求方式:get
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
车型id
2.13 精准选车条件
备注:精准选车条件
请求URL:http://mrobot.pcauto.com.cn/v3/price/models/criterionv36?v=4.0.0
HTTP请求方式:get
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
1)变速器改成变速箱
2)所有条件加入“不限”选项
2.14 精准选车-车系列表
备注:精准选车,获取车系列表接口
请求URL:http://mrobot.pcauto.com.cn/v2/price/models/search?queryJson={"cluster_kind":["紧凑型车"]}&pageNo=1&orderId=1&type=1
HTTP请求方式:get
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
queryJson:查询条件
pageNo:页码
orderId:排序方式,1为最热门,2为最新,3为最便宜,4为最贵
type=1
2.15 汽车网车系列表
备注:搜索接口,搜索某品牌下的车系
请求URL:http://mrobot.pcauto.com.cn/v3/price/models/search?keyword=大众&pageNo=1&pageSize=1000
HTTP请求方式:get
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
keyword:查询条件
pageNo:页码
pageSize:一页条数
2.16 车系页
备注:车系终端页
请求URl:http://mrobot.pcauto.com.cn/v3/price/serialv40/3404?v=4.0.0&modelIds=19792
HTTP请求方式:get
是否需要登录:否
返回格式:html页面
缓存方式:无
缓存时间:无
请求参数:
车系id
v=4.0.0
modelIds:记录在客户端本地的已经加入对比的车型id列表
阅读模式:无参数 白天;night 晚间
2.17 经销商详情页
备注:经销商详情页。添加预约试驾和促销信息,促销信息来自网站已有的数据
请求URl:http://mrobot.pcauto.com.cn/v3/price/dealersDetailv40?areaId=1&modelId=19792&seq=497120001&modelName=%E7%A6%8F%E5%85%8B%E6%96%AF+2012%E6%AC%BE+%E4%B8%A4%E5%8E%A2+1.6+MT+%E8%88%92%E9%80%82%E5%9E%8B&modelId2=19792
HTTP请求方式:get
是否需要登录:否
返回格式:html页面
缓存方式:无
缓存时间:无
请求参数:
areaId
modelId
seq
modelName
modelId2
阅读模式:无参数 白天;night 晚间
2.18 询底价页
备注:询底价页
请求URl:http://mrobot.pcauto.com.cn/v3/price/askprice?dealerId=49712&dealerName=%E5%B9%BF%E5%B7%9E%E6%96%87%E5%8D%8E%E7%A6%8F%E7%91%9E%E7%A6%8F%E7%89%B9+&modelId=19792&modelName=%E7%A6%8F%E5%85%8B%E6%96%AF+2012%E6%AC%BE+%E4%B8%A4%E5%8E%A2+1.6+MT+%E8%88%92%E9%80%82%E5%9E%8B&url=http://img.pconline.com.cn/images/upload/upc/tx/auto5/1210/11/c3/14373198_14373198_1349942613212_120x90.jpg
HTTP请求方式:get
是否需要登录:否
返回格式:html页面
缓存方式:无
缓存时间:无
请求参数:
dealerId
dealerName
modelId
modelName
url:车型图片链接
阅读模式:无参数 白天;night 晚间
2.19 车型终端页
备注:车型终端页
请求URl:http://mrobot.pcauto.com.cn/v3/price/modelsv40/27149?areaId=1&isCompared=0&app=pcautobrowser&v=4.1.0&night
HTTP请求方式:get
是否需要登录:否
返回格式:html页面
缓存方式:无
缓存时间:无
请求参数:
modelId:车型id
areaId
isCompared:车型id存在 1;不存在 0
app=pcautobrowser
v=4.1.0
阅读模式:无参数 白天;night 晚间
2.20 车系图片列表-部分
备注:车系图片列表-部分
请求URL:http://mrobot.pcauto.com.cn/v2/price/pictures?serialGroupId=10059&fmt=json&pageSize=999&typeId=3
HTTP请求方式:get
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
serialGroupId:车系id
fmt:返回格式
pageSize:一页条数
typeId:部件:1为外观,2为内饰,3为其他细节,4为官方图
2.21 预约驾车页
备注:预约驾车页
请求URL:http://mrobot.pcauto.com.cn/v3/price/testdriver/
HTTP请求方式:get
是否需要登录:否
返回格式:html页面
缓存方式:无
缓存时间:无
请求参数:
dealerId
dealerName
modelId
modelName
url:车型图片链接
阅读模式:无参数 白天;night 晚间
2.22 获取我的订阅
备注:我的订阅
请求URL:http://mrobot.pcauto.com.cn/v3/bbs/getCars?type=1&pageNo=1&pageSize=1000
HTTP请求方式:get
是否需要登录:是
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
common_session_id:用户登陆后获得的认证id
type:类型,此处为1
pageNo:页数
pageSize:每页显示多少条
2.23 增加订阅
备注:增加订阅,说明:不支持批量添加
请求URL:http://my.pcauto.com.cn/intf/modifyCar.jsp?act=save&req_enc=utf-8&resp_enc=utf-8&series=3054
HTTP请求方式:get
是否需要登录:是
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
common_session_id:用户登陆后获得的认证id
series:车系id
返回参数:
{
carId = 518669;
carPic = "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1207/16/c4/12351711_12351711_1342426522843_270x202.jpg";
code = 1;
message = "保存数据成功";
}
2.24 删除订阅
备注:删除订阅,说明:不支持批量删除
请求URL:http://my.pcauto.com.cn/intf/modifyCar.jsp?act=delCar&req_enc=utf-8&resp_enc=utf-8&carId=518663
HTTP请求方式:get
是否需要登录:是
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
common_session_id:用户登陆后获得的认证id
carId:爱车id
返回参数:
{
code: 1,
message: "删除数据成功"
}
2.25 同步内容上传
备注:同步论坛收藏的内容
请求URL:http://mrobot.pcauto.com.cn/v3/bbs/collectionUpload
HTTP请求方式:post
是否需要登录:是
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
common_session_id:用户登陆后获得的认证id
json:需要上传的数据提交给该参数。
注:series,model为汽车网客户端独有
返回参数:
{
“series”:{ //车系
“addList”:[123121,1111,2222,3333,566788], //新增车系id数组,此处的id即为同步下载接口中的seriesId,没有新增的车系该字段留空,即“addList”:[],如下同。
“deleteList”:[12356,6666,5555,32145] //删除车系数组,此处的id为爱车id,即为同步下载接口中seriesList下的id字段
},
"model":{ //车型
“addList”:[{serialId:111, modelId:111},{serialId:111, modelId:111}], //新增车型id数组,serialId为车系id,modelId为车型id
“deleteList”:[12356,6666,5555,32145] //删除车型数组,此id为爱车id,即为同步下载接口中modelList的id字段
},
“forum”:{ //论坛
“addList”:[123121,1111,2222,3333,566788], //新增论坛id数组,此处的id即为同步下载接口中的forumId
“deleteList”:[12356,6666,5555,32145], //删除论坛数组,此id为收藏id,即为同步下载接口中forumList下的id字段
},
“topic”:{ //帖子
“addList”:[123121,1111,2222,3333,566788], //新增帖子id数组,此处的id即为同步下载接口中的topicId
“deleteList”:[12356,6666,5555,32145], //删除论坛数组,此id为收藏id,即为同步下载接口中topicList下的id字段
},
“pieforum”:{ //论坛
“addList”:[123121,1111,2222,3333,566788], //新增论坛id数组,此处的id即为同步下载接口中的forumId
“deleteList”:[12356,6666,5555,32145], //删除论坛数组,此id为收藏id,即为同步下载接口中forumList下的id字段
},
“pietopic”:{ //帖子
“addList”:[123121,1111,2222,3333,566788], //新增帖子id数组,此处的id即为同步下载接口中的topicId
“deleteList”:[12356,6666,5555,32145], //删除论坛数组,此id为收藏id,即为同步下载接口中topicList下的id字段
}
}
2.26 添加收藏的文章
备注:添加收藏的文章
请求URL:http://my.pcauto.com.cn/intf/FavorArticle.jsp?act=addFavorarticle
HTTP请求方式:post
是否需要登录:是
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
common_session_id:用户登陆后获得的认证id
favorArticleId:文章id,如果要批量添加,id参数的拼接方式为,favorArticleId=xxxxx,xxxxx
2.27 添加收藏的车型
备注:添加收藏的车型,说明:此接口不支持批量添加
请求URL:http://my.pcauto.com.cn/intf/modifyCar.jsp?act=save
HTTP请求方式:post
是否需要登录:是
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
common_session_id:用户登陆后获得的认证id
series:车系id
model:车型id
2.28 添加收藏的帖子
备注:添加收藏的帖子
请求URL:http://bbs.pcauto.com.cn/action/user/favorite.jsp
HTTP请求方式:post
是否需要登录:是
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
common_session_id:用户登陆后获得的认证id
tid:帖子id
2.29 删除收藏的文章
备注:删除收藏的文章
请求URL:http://my.pcauto.com.cn/intf/FavorArticle.jsp?act=delFavorarticle
HTTP请求方式:post
是否需要登录:是
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
common_session_id:用户登陆后获得的认证id
favorArticleId:文章id,如果要删除添加,id参数的拼接方式为,favorArticleId=xxxxx,xxxxx
2.30 删除收藏的车型
备注:添加删除的车型,说明:此接口不支持批量删除
请求URL:http://my.pcauto.com.cn/intf/modifyCar.jsp?act=delCar
HTTP请求方式:post
是否需要登录:是
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
common_session_id:用户登陆后获得的认证id
carId:爱车id
2.31 删除收藏的帖子
备注:删除收藏的帖子
请求URL:http://bbs.pcauto.com.cn/action/user/favorite_delete.jsp
HTTP请求方式:post
是否需要登录:是
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
common_session_id:用户登陆后获得的认证id
tid:帖子id,如果一次性要删除收藏的多条帖子,请拼接多个id参数,即:id=xxx&id=xxx
2.32 判断版块、帖子是否已经收藏
备注:判断版块、帖子是否已经收藏
请求URL:http://bbs.pcauto.com.cn/action/user/check_favorite.jsp
HTTP请求方式:post
是否需要登录:是
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
common_session_id:用户登陆后获得的认证id
fid:版块id
tid:帖子id
返回参数:如果已经登陆并且版块或者帖子已经收藏,返回收藏id,否则返回-1
2.33 收藏夹信息---文章
备注:判断版块、帖子是否已经收藏
请求URL:http://mrobot.pcauto.com.cn/v3/bbs/getFavoriteArticles?pageNo=1&pageSize=20
HTTP请求方式:get
是否需要登录:是
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
common_session_id:用户登陆后获得的认证id
pageNo:页数
pageSize:每页显示多少条
2.34 收藏夹信息---车型
备注:收藏夹信息---车型
请求URL:http://mrobot.pcauto.com.cn/v3/bbs/getCars?type=0&pageNo=1&pageSize=20
HTTP请求方式:GET
是否需要登录:是
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
common_session_id:用户登陆后获得的认证id
type:类型,此处为0
pageNo:页数
pageSize:每页显示多少条
2.35 收藏夹信息---帖子
备注:收藏夹信息---帖子
请求URL:http://mrobot.pcauto.com.cn/v3/bbs/getFavoriteTopics/826717?pageNo=1&pageSize=20
HTTP请求方式:get
是否需要登录:是
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
common_session_id:用户登陆后获得的认证id
用户id
pageNo:页数
pageSize:每页显示多少条
2.36 个人中心-我的帖子
备注:个人中心-我的帖子
请求URL:http://mrobot.pcauto.com.cn/v3/bbs/myTopics/13128876?pageNo=1&pageSize=20&maxLength=20
HTTP请求方式:get
是否需要登录:是
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
filter:post|pick(post:回帖,pick:精华贴),缺省参数为主贴
pageNo:页码
pageSize:一页条数,默认20,最大500
maxLength
2.37 获取新消息数量
备注:获取个人中心的新消息的数量。提醒包含一下几种:1.我发的帖子,别人回帖;2.我发的回帖,别人回复;3.我发的文章评论,别人回复
请求URL:http://mrobot.pcauto.com.cn/v3/bbs/getNewMsgCount
HTTP请求方式:get
是否需要登录:是
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
common_session_id:用户登陆后获得的认证id
2.38 清零系统消息
备注:清零系统消息
请求URL:http://mrobot.pcauto.com.cn/v3/bbs/setNewMsgState
HTTP请求方式:post
是否需要登录:是
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
messageType:1
typeIds:2004
2.39 搜索贴子
备注:搜索贴子
请求URL:http://mrobot.pcauto.com.cn/v3/bbs/search?q=che&pageNo=1&pageSize=20
HTTP请求方式:get
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
q:搜索关键字
pageNo:页码
pageSize:每页显示多少条
2.40 搜索资讯
备注:搜索资讯
请求URL:http://mrobot.pcauto.com.cn/v2/cms/search?q=che
HTTP请求方式:get
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
q:搜索关键字
2.41 分类栏目资讯搜索
备注:搜索资讯
请求URL:http://mrobot.pcauto.com.cn/v2/cms/search?q=car&clusterQuery=(cluster_channel:新闻动态)
HTTP请求方式:get
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
q:搜索关键字
clusterQuery=(cluster_channel:分类栏目)
2.42 用户体验计划
备注:用户体验计划
请求URL:http://www.pconline.com.cn/sjzh/ued/app/auto/iphone/
HTTP请求方式:get
是否需要登录:否
返回格式:html页面
缓存方式:无
缓存时间:无
请求参数:无
2.43 栏目页topArticle增加楼层数和图集张数
备注:添加total字段;并且给所有栏目实现分页功能
请求URL:http://mrobot.pcauto.com.cn/v2/cms/channels/1
HTTP请求方式:get
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
栏目ID
2.44 车系聚合页
备注:获取车系聚合页数据
请求URL:http://mrobot.pcauto.com.cn/v2/cms/serialMixedData/228?pageNo=1&pro=广东省&city=广州市&v=4.0.0
HTTP请求方式:get
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:无
请求参数:(说明:客户端获取http://whois.pconline.com.cn/ipJson.jsp?level=2的返回参数,作为本接口area参数的值请求本接口)
已经订阅的车系id
pageNo:页数
pageSize:每页显示多少条
pro:省份,截取从接口http://whois.pconline.com.cn/ipJson.jsp?level=2中返回的参数中的pro
city:省份,截取从接口http://whois.pconline.com.cn/ipJson.jsp?level=2中返回的参数中的city
v=4.0.0
2.45 文章终端页
备注:获取文章
请求URL:http://mrobot.pcauto.com.cn/v3/cms/articles/4147040?articleTemplate=3.6.0&size=18&app=pcautobrowser&picRule=2&template=(null)&channelId=4&serialId=0
HTTP请求方式:get
是否需要登录:否
返回格式:html页面
缓存方式:无
缓存时间:无
请求参数:
文章ID
articleTemplate=3.6.0
size:字体大小
app=pcautobrowser
picRule:请求网络方式:0 非wifi; 2 wifi访问
pageNo:页码
template:模板
channelId:栏目ID
serialId:车系ID
date:文章直播时间(说明:当参数template=live时,传递date,否则不传)
阅读模式:无参数 白天;night 晚间
2.46 获取文章最新评论楼层数
备注:获取文章最新评论楼层数
请求URL:http://mrobot.pcauto.com.cn/v3/cmt/get_newest_floor?url=http://www.pcauto.com.cn/pingce/414/4147099.html
HTTP请求方式:get
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
url:文章主题url
2.47 获取评论
备注:获取文章评论
请求URL:http://mrobot.pcauto.com.cn/v3/cmt/new_topics/13118127?articleId=4147040&reverse=0&pageNo=1&pageSize=20
HTTP请求方式:get
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
topicId:主题ID
articleId:文章ID
reverse:排序方式:0 倒序; 1 正序
pageNo:页码
pageSize:每页行数
2.48 顶评论
备注:顶评论
请求URL:http://cmt.pcauto.com.cn/action/comment/support_json.jsp?cid=26821494&sp=1
HTTP请求方式:get
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
cid:评论ID
sp=1(顶数量+1)
2.49 回复文章评论
备注:回复文章评论
请求URL:http://cmt.pcauto.com.cn/action/comment/create_utf8.jsp
HTTP请求方式:post
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
topicId:主题ID
topicUrl:主题url
articleTitle:文章标题
content:回复内容
name:用户名
是否匿名:0 否
replyFloor:回复楼层
articleId:文章ID
2.50 车型降价信息
备注:获取某个车系下在售车型的降价信息
请求URL:http://mrobot.pcauto.com.cn/v3/price/getDepreciateModelBySerialId/3544?pageNo=1&pageSize=20&pro=广东省&city=广州市
HTTP请求方式:get
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
serialId:车系id
pageNo:第几页
pageSize:每页显示多少条
pro:省份,截取从接口http://whois.pconline.com.cn/ipJson.jsp?level=2中返回的参数中的pro
city:省份,截取从接口http://whois.pconline.com.cn/ipJson.jsp?level=2中返回的参数中的city
2.51 顶踩接口
备注:对某个对象赞或者踩
请求URL:http://mdata.pcauto.com.cn/pcauto/user/ups-downs.jsp?id=4147099&type=1&action=1
HTTP请求方式:post
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:无
请求参数:(说明:参数错误以及非post方法提交会返回400的status code)
id:112(文章、帖子或者图集id)
type:1( 类型id,1为文章、2为帖子或者3为图集)
action:3 (动作,1为‘顶’、2为‘踩’、3为‘取消顶’、4为‘取消踩’)
返回参数:
{
"id":123 // 文章、帖子或者图集id
"type":1, // 类型id,1为文章、2为帖子,3为图集
"resultCode":0, // 0表示成功,-1表示失败
"msg":"提示信息", // 提示信息
"ups":123, // 赞的数量
"downs":123 // 踩的数量
}
2.52 文章、帖子获取顶踩数
备注:获取某个对象的顶踩数
请求URL:http://mrobot.pcauto.com.cn/v3/cmt/getUpsDowns?params={"params":[{"id":4147099,"type":1}],"flag":1}
HTTP请求方式:post
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
params:此参数为json格式的字符串,具体格式如下:
{
"flag": 1,
"params":
[
{
"type": 1, //对象类型,1为文章;2为帖子;3为图集
"id": 3147444 //文章id、帖子id或者图集id
}
]
}
2.53 获取个人私信
备注:获取个人私信
请求URL:http://mrobot.pcauto.com.cn/v3/bbs/getMessage?pageSize=20&pageNo=1&userId=24286812
HTTP请求方式:get
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
common_session_id:用户登陆后获得的认证id
userId:对方的用户id
2.54 获取用户信息
备注:获取用户信息
请求URL:http://mrobot.pcauto.com.cn/v3/bbs/getUserInfo
HTTP请求方式:get
是否需要登录:是
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
uid:用户ID,如果没有次参数则返回当前用户信息
返回参数:
{
"image":头像
"isVip":是否认证车主
"level":用户级别
"name":用户名
"nickname":用户昵称
"serialId":认证车系ID
"serialName":认证车系名
"userId":用户ID
"friends":关注好友数
"fans":粉丝数
}
2.55 车主点评列表页
备注:获取某车系下的车主点评列表。接口为网页,点击网页中列表,跳转协议为:pcaction://pcauto-owner-review?modelId=${id}
请求URL:http://mrobot.pcauto.com.cn/v3/price/commentList/3404
HTTP请求方式:get
是否需要登录:否
返回格式:html页面
缓存方式:无
缓存时间:无
请求参数:
车系id
阅读模式:无参数 白天;night 晚间
2.56 车主点评终端页
备注:车主点评终端页
请求URL:http://mrobot.pcauto.com.cn/v3/price/commentDetail/19799
HTTP请求方式:get
是否需要登录:否
返回格式:html页面
缓存方式:无
缓存时间:无
请求参数:
车型id
阅读模式:无参数 白天;night 晚间
2.57 获取回帖回复提醒内容
备注:获取回帖回复列表。说明:本接口和获取新消息的接口 http://trac.pc.com.cn/iphone/wiki/pcauto_4.0.0/interface#a2.6新消息 有相关联系。调用获取回帖成功会清零这个接口的forumReplyCount字段;调用获取评论回复成功会清零这个接口的commentReplyCount字段
请求URL:http://mrobot.pcauto.com.cn/v3/bbs/getTopicReplyReminds?pageSize=20&pageNo=1
HTTP请求方式:get
是否需要登录:是
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
common_session_id:用户登陆后获得的认证id
pageNo:页数
pageSize:每页显示多少条
2.58 获取文章评论回复列表
备注:获取文章评论回复列表。说明:本接口和获取新消息的接口 http://trac.pc.com.cn/iphone/wiki/pcauto_4.0.0/interface#a2.6新消息 有相关联系。调用获取回帖成功会清零这个接口的forumReplyCount字段;调用获取评论回复成功会清零这个接口的commentReplyCount字段
请求URL:http://mrobot.pcauto.com.cn/v3/bbs/getTopicReplyReminds?pageSize=20&pageNo=1
HTTP请求方式:get
是否需要登录:是
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
common_session_id:用户登陆后获得的认证id
pageNo:页数
pageSize:每页显示多少条
返回参数:
{
"pageNo":1,
"pageSize":20,
"total":200,
"resultList": [
{
"id": 123123, //1和2时,为帖子id,为3时是文章id
"type": 1,//1回复主贴,2回复回帖,3回复文章评论
"face": "",//头像
"userName": "xxx",//昵称
"userId": 6546,
"replyToUserName":"xxx", // type为1时该字段有效。当用户A在我的主帖里回复了用户B,该字段返回用户B的昵称
"replyToUserId":123, //该字段返回的时id,其他同"reply-to-userName"
"noticeId":123,消息id(删除消息需用此字段)
"createAt": 1382582506000,
"toReply": "引用内容",
"content": "回复内容",
"topicId":123, // 如果这条回复是评论,则这是对应评论列表的主题id;如果是回复帖子,为0
"topicUrl":"" , // 如果这条回复是评论,则这是对应评论列表的主题url;如果是回复帖子,为空字符串
"title":"", // 帖子或者文章标题
"floorId":123 , // 该回复的楼层id,评论和帖子都用这个字段
"floor":123 // 该回复的楼层数,评论和帖子都用这个字段
}
]
}
ps:这接口内容有3种
1.我发的帖子,别人回帖
2.我发的回帖,别人回复
3.我发的文章评论,别人回复
2.59 车型对比结果页
备注:车型对比页
请求URL:http://mrobot.pcauto.com.cn/v3/price/detailComparev40?id1=26138&id2=26139
HTTP请求方式:get
是否需要登录:否
返回格式:html页面
缓存方式:无
缓存时间:无
请求参数:
id1:对比车量1
id2:对比车辆2
阅读模式:无参数 白天;night 晚间
2.60 车型相关文章
备注:车型相关文章,在原来的基础上添加顶踩数
请求URL:(获取某个车系下的文章列表)http://mrobot.pcauto.com.cn/v3/price/getNewestInfoListBySerialId/9010?pageNo=1&pageSize=20
(新闻文章列表) http://mrobot.pcauto.com.cn/v3/price/getNewsListBySerialId/3524?pageNo=1&pageSize=20
(评测文章列表)http://mrobot.pcauto.com.cn/v3/price/getProfileListBySerialId/3524?pageNo=1&pageSize=20
(导购文章列表)http://mrobot.pcauto.com.cn/v3/price/getGuideListBySerialId/3524?pageNo=1&pageSize=20
HTTP请求方式:get
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
serialId:车系id
ageNo:页码
pageSize:每页行数
2.61 行情文章列表
备注:获取行情下的文章列表,在原来的基础上添加顶踩数
请求URL:http://mrobot.pcauto.com.cn/v3/price/getArticlePriceListBySerialId/3524?pageNo=1&pageSize=20&areaId=1
HTTP请求方式:get
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
serialId:车系id
ageNo:页码
pageSize:每页行数
areaId:地域id
2.62 评论推广
备注:获取评论的推广内容,由编辑在cms里维护
请求URL:http://mrobot.pcauto.com.cn/v3/bbs/commentExtend
HTTP请求方式:get
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:无
请求参数:无
返回参数:
{
"data": [
{
"image": "http://xxxxxx",
"to-uri": "pcautobrowser://information-article/id"
}
]
}
2.63 个人中心推广
备注:获取个人中心的推广内容,由编辑在cms里维护
请求URL:http://mrobot.pcauto.com.cn/v3/bbs/personalExtend
HTTP请求方式:get
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:无
请求参数:无
返回参数:
{
"data": [
{
"title": "我是文字链",
"to-uri": "pcautobrowser://information-article/id"
}
]
}
2.64 找车搜索关键字
备注:动态获取搜索关键字,由编辑在cms里维护
请求URL:http://mrobot.pcauto.com.cn/v3/price/modelsForSearch
HTTP请求方式:get
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:无
请求参数:无
返回参数:
{
"modelList": [
{
"id": 123,
"name": "蒙迪欧"
}
]
}
2.65 降价
备注:降价
请求URL:http://m.pcauto.com.cn/auto/market/r1.html?fromPcautoApp
HTTP请求方式:get
是否需要登录:否
返回格式:html页面
缓存方式:无
缓存时间:无
请求参数:无
2.66 修改昵称
备注:修改昵称
请求URL:http://my.pcauto.com.cn/intf/syncNickName.jsp
HTTP请求方式:post
是否需要登录:是
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
req_enc:UTF-8
resp_enc:UTF-8
nickName:昵称
act:save
返回参数:
{"code":0}表示成功, {"code":非0,"message":"提示"}
2.67 修改头像
备注:修改头像
请求URL:http://upc.pcauto.com.cn/upload_head.jsp
HTTP请求方式:post
是否需要登录:是
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
二进制图片数据
返回参数:
成功:{retCode: 0} 失败:{retCode: xxx}
2.68 获取用户好友列表
备注:返回包括关注的好友和粉丝
请求URL: http://my.pcauto.com.cn/intf/app/focus.jsp?accountId=31836836&act=findFocus&common_session_id=6E2073035FC49C29DD038821CAF2058F93196617DE299753&resp_enc=UTF-8&pageNo=1&pageSize=20&req_enc=UTF-8
HTTP请求方式:get
是否需要登录:是
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
accountId:用户ID,如果没有改参数的话则返回当前用户的好友列表
act:findFocus为关注,findFocusBy为粉丝
pageNo:页码
pageSize:页长度
common_session_id
req_enc:UTF-8
resp_enc:UTF-8
返回参数:
{
"total":18,
"pageCount":2,
"pageNo":1,
"pageSize":20,
"resultList":[
{
"accountId":用户ID
"focusNum":关注好友数
"fanNum":粉丝数
"nickName":用户昵称
"image":头像
}
]
}
2.69 验证码接口
备注:验证码接口
请求URL:http://captcha.pcauto.com.cn/captcha/v.jpg
HTTP请求方式:get
是否需要登录:否
返回格式:
缓存方式:无
缓存时间:无
请求参数:无
返回参数:
返回一张验证码图片
2.70 发私信接口
备注:发私信接口
请求URL:http://bip.pcauto.com.cn/intf/message.jsp
HTTP请求方式:post
是否需要登录:是
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
accountId:用户ID
act=create
accountId:发送给某个用户
content:消息内容
captcha:验证码
req_enc:UTF-8
resp_enc:UTF-8
(说明:发送限制)
1.post
2.验证码
3.黑名单
4.邮箱绑定,该限制仅限於2012-01-01起注册的用户
5.发送频率 50次/ID/24H
6.白名单最多一次发送50个用户,非白名单则每次只能发一个
7.添加关键词库过滤
返回参数:
{code:0,message:"提示"}
2.71 收发私信列表
备注:收到与发出的私信列表
请求URL:http://mrobot.pcauto.com.cn/v3/bbs/getMessageList?type=1&common_session_id=6E2073035FC49C29DD038821CAF2058F93196617DE299753&resp_enc=UTF-8&siteId=2&status=-1&pageNo=1&pageSize=20&req_enc=UTF-8
HTTP请求方式:get
是否需要登录:是
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
type:私信类型(1 收到的私信; 0 发出的私信)
siteId:网站ID(1是电脑网,2是汽车网,3是游戏网,4是女性网,5是亲子网,6是家居网)
status:私信状态(-1为已读和未读,0表示未读,1表示已读)
pageNo:页码
pageSize:一页条数,默认20,最大500
common_session_id
req_enc:UTF-8
resp_enc:UTF-8
返回参数:
{
total: 总的条数
pageNo: 页码
pageCount: 页数
pageSize: 每页条数
resultList:{
id: 消息ID
content: 消息内容
createTime: 发送时间
status: 阅读状态
accountId: 用户ID
senderId: 发送者ID
receiverNickname:发送者昵称
receiverFace:头像
replyId: 回复ID
showStatus: 显示状态
}
}
2.72 获取他人最新动态接口
备注:获取他人最新动态接口
请求URL:http://mrobot.pcauto.com.cn/v3/bbs/newsfeed/31836836
HTTP请求方式:get
是否需要登录:是
返回格式:html页面
缓存方式:无
缓存时间:无
请求参数:
UID:用户ID
2.73 个人中心 - 我的评论
备注:个人中心 - 我的评论
请求URL:http://mrobot.pcauto.com.cn/v3/cmt/userCmtList/31836836
HTTP请求方式:get
是否需要登录:是
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
UID:用户ID
webSite:pcauto
返回参数:
{
"data": [
{
"articleId": 4003061,
"content": "很好的文章!!说不定哪天就用到了!!",
"createTime": 1394361427000,
"floor": 12,
"id": 26731760,
"ip": "192.168.239.90-113.64.110.39",
"nickname": "dufu163",
"replyRef": {
},
"status": 2,
"topicId": 13113197,
"topicTitle": "证照手续不用愁(3)驾驶证丢了怎么办?",
"topicUrl": "http://www.pcauto.com.cn/drivers/400/4003061.html",
"url": "http://cmt.pcauto.com.cn/topic/a0/r0/p1/ps20/t13113197.html"
}
],
"pageNo": 1,
"pageSize": 20,
"status": 0,
"total": 1,
"uid": 31836836
}
2.74 关注&取消关注
备注:关注&取消关注
请求URL:http://m.pcauto.com.cn/bip/intf/focus.jsp
HTTP请求方式:post
是否需要登录:是
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
act=add|delete(add:关注,delete:取消关注)
accountId=xxxxxx 当前用户ID
friendId=xxxxxx 关注用户ID
req_enc:UTF-8
resp_enc:UTF-8
common_session_id
返回参数:
{"code":0}成功
2.75 判断与某用户的关系
备注:判断与某用户的关系
请求URL:http://m.pcauto.com.cn/bip/intf/focus.jsp
HTTP请求方式:get
是否需要登录:是
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
act=isHisFocus
accountId=xxxxxx 当前用户ID
friendId=xxxxxx 关注用户ID
req_enc:UTF-8
resp_enc:UTF-8
common_session_id
返回参数:
0:没关注,1:关注,2:被关注,3:相互关注
2.76 获取系统消息
备注:获取系统消息
请求URL:http://bip.pcauto.com.cn/intf/sysnotice.jsp?act=find&common_session_id=6E2073035FC49C29DD038821CAF2058F93196617DE299753&noTemplate=true&resp_enc=UTF-8&siteId=2&typeIds=2004&status=-1&pageNo=1&pageSize=20&req_enc=UTF-8
HTTP请求方式:get
是否需要登录:是
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
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
返回参数:
{
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: 操作结果
}
2.77 获取爱车列表
备注:获取爱车列表
请求URL:http://my.pcauto.com.cn/intf/getCars.jsp
HTTP请求方式:get
是否需要登录:是
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
act{
=getCars 获取该用户所有爱车;
=getCarSeries获取该用户的添加的车型;
=getCarModels获取该用户的添加的车系;
}
accountId = (不传此参数,将获取登录ID,);
pageNo = (次参数不传,则为默认为1,即第一页);
pageSize = (次参数不传,则为默认为20,最小为1,最大为100);
callback = (回调函数)
返回参数:
失败:{"code":-1,"message":""}
成功:{
"total":5,
"pageNo":1,
"pageCount":1,
"pageSize":20,
"resultList":[
"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.78 收集推送token接口
备注:token数据放在passport2,赖子粼负责
请求URL:http://passport2.pconline.com.cn/passport2/api/mobilePushInfo.jsp
HTTP请求方式:post
是否需要登录:是
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
act=addMobilePushInfo
deviceType=iOS//设备类型
token=xxx//推送token
返回参数:
{"code":0,"message":"数据已经插入"}