| Version 10 (modified by wuhuixuan, 11 years ago) (diff) |
|---|
Table of Contents
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分钟
请求参数:
| 参数名 | 类型 | 必须 | 说明 |
| serialId | string | 必须 | 车系id |
| modelId | string | 可选 | 车型id,查车系的时候不用传 |
| colorId | string | 可选 | 颜色id,查全部颜色的时候不用传 |
| typeId | string | 可选 | 类型id,查全部类型得时候不用传 |
| v | string | 必须 | 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分钟
请求参数:
| 参数名 | 类型 | 必须 | 说明 |
| status | string | 必须 | -1为已读和未读,0表示未读,1表示已读 |
| common_session_id | string | 必须 | 登录session |
| pageNo | string | 可选 | 页码 |
| pageSize | string | 可选 | 一页条数,默认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分钟
说明:增加价格区间和级别的筛选条件
请求参数:
| 参数名 | 类型 | 必须 | 说明 |
| areaId | string | 必须 | 地区id |
| brandId | string | 可选 | 品牌id |
| serialId | string | 可选 | 车系id |
| modelId | string | 可选 | 车型id |
| orderBy | string | 必须 | popularity, newest, discountRange, lowestPrice;分别指按车型热度,按最新,按降价幅度,按最低价格 |
| ps | string | 可选 | 最低价格,如13,单位万元 |
| pe | string | 可选 | 最高价格,单位万元 |
| jb | string | 可选 | 级别,如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
-
太平洋汽车网供App4.6拆分接口文档_1.3.doc
(350.1 KB) -
added by liangzhicong 11 years ago.
性能优化接口文档
-
地区经销商缓冲优化v3.docx
(103.2 KB) -
added by liangzhicong 11 years ago.
地区和经销商缓冲接口优化文档
![(please configure the [header_logo] section in trac.ini)](http://www1.pconline.com.cn/hr/2009/global/images/logo.gif)