wiki:pcauto_4.6.0/interface

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

--

1.基本约定

接口通用参数
req_enc=utf-8(必须放url后面)
resp_enc=utf-8(必须放url后面)
common_session_id=xxxx(以cookies中的优先)

接口URL: 接口URL
||参数名||类型||必须||说明||
说明文档参数:添加某特定参数可以直接看接口文档
是否需要登录:是|否
返回格式:json|xml|ssi,
缓存方式:接口缓存(接口中返回的响应头里面的 Cache-Control),对象缓存()
缓存时间:缓存时间
返回结果:结果可能情况

2.接口列表

2.1 资讯

2.1.1 文章收藏批量操作

2.1.2 获取账号的收藏文章

2.1.3 视频文章终端页

3.1 找车

3.1.1 车系车型图片筛选条件

请求url:http://mrobot.pcauto.com.cn/v2/price/pictureConditions?serialId=7889&modelId=0&colorId=0&typeId=0&v=4.5.0
后端地址:
请求方式:GET
是否需要登录:否
返回格式:JSON
缓存方式:接口缓存
缓存时间:60分钟
请求参数:

参数名类型必须说明
serialIdstring必须车系id
modelIdstring可选车型id,查车系的时候不用传
colorIdstring可选颜色id,查全部颜色的时候不用传
typeIdstring可选类型id,查全部类型得时候不用传
vstring必须v=4.5.0 4.5版本增加类型细化,颜色值


返回结果:
{ colors: [{ count: "479", id: "44908", isMetal: "0", name: "平安白", value: "(245,245,245)" }], models: [{ count: "91", id: "34205", name: "2015款 1.4 手动 舒适版" }], types: [{ id: "1", name: "外观", section: [{ id: "1", name: "全部" }] }] }

3.1.2 车型综述页

请求url:
说明:
客户端4.5版本的请求url: http://mrobot.pcauto.com.cn/v3/price/modelsv45/${modelId}?areaId=1&modelIds=modelIds=28350,32262
客户端4.6新增一个跳转协议,为了不影响4.5版本使用,4.6需要使用新版本接口
新增协议如下:
点击竞争车型协议pcautobrowser://model/30499(车型id)

4.1 个人中心

4.1.1 获取系统消息

说明:需要新版本接口,因为4.5要过滤a标签,4.6不需要过滤 原请求url:http://mrobot.pcauto.com.cn/v3/bbs/getSysNotice?status=-1&pageSize=20&pageNo=1&common_session_id=DA4C99E3FDF2FDE541D7A9319891798C2DD2AFCE4E6EEB28
后端地址: http://bip.pcauto.com.cn/intf/sysnotice.jsp
请求方式:GET
是否需要登录:是
返回格式:JSON
缓存方式:接口缓存
缓存时间:60分钟
请求参数:

参数名类型必须说明
statusstring必须-1为已读和未读,0表示未读,1表示已读
common_session_idstring必须 登录session
pageNostring可选页码
pageSizestring可选一页条数,默认20,最大500


返回结果:
{ pageCount: 1, pageNo: 1, pageSize: 20, resultList: [{ accountId: 33375426, content: "年底抢楼送大奖,说出对新年愿望祝福——送儿童安全座椅、投影机、行车记录仪、京东购物卡、移动电源!!! http://bbs.pcauto.com.cn/topic-5955076.html", createTime: 1417500858000, groupSend: 1, groupType: 0, id: 124624885, senderId: 0, siteId: 2, status: 1, type: { groupType: 1, id: 0, name: "系统消息", siteId: 0, templateId: 0 }, typeId: 41 }], total: 13 }
content字段的跳转内容加上html标签,客户端做识别和跳转

5.1 优惠

4.1.1 优惠降价列表

请求url:http://mrobot.pcauto.com.cn/v3/price/promotionList?areaId=1&pageNo=1&pageSize=20&orderBy=discountRange
HTTP请求方式:GET
是否需要登录:false
返回格式:JSON
缓存方式:接口缓存
缓存时间:60分钟
说明:增加价格区间和级别的筛选条件
请求参数:

参数名类型必须说明
areaIdstring必须地区id
brandIdstring可选品牌id
serialIdstring可选车系id
modelIdstring可选车型id
orderBystring必须popularity, newest, discountRange, lowestPrice;分别指按车型热度,按最新,按降价幅度,按最低价格
psstring可选最低价格,如13,单位万元
pestring可选最高价格,单位万元
jbstring可选级别,如71


返回结果: {

"data": [

{

"area": "广州", "createTime": 1406602096000, "dealerId": "45742", "dealerName": "进口大众广州鸿众", "dealerNewsId": "5154551", "dealerType": "综合店", "decline": "35.0", "discount": "163400", "image": " http://img.pconline.com.cn/images/upload/upc/tx/auto5/1308/01/c8/24016521_1375350331166_350x260.jpg", "is400": "1", "isShow24Icon": 1, "modelId": "32583", "modelName": "高尔夫(进口) 2014款 2.0 TSI R敞篷版", "modelPrice": "46.68", "phone": "400-860-0819", "price": "30.34", "serialGroupId": 4391, "serialGroupName": "高尔夫(进口)"

}

], "pageNo": 1, "pageSize": 20, "total": 6559

}

Attachments