![(please configure the [header_logo] section in trac.ini)](http://www1.pconline.com.cn/hr/2009/global/images/logo.gif){kind=logo}
| Version 112 (modified by limingjiu, 12 years ago) (diff) |
|---|
接口文档
2.0 辅助接口
2.0.1.城市切换(已有接口)
获取可切换的城市列表
2.0.2. 获取当前用户的可团购车系列表
请使用： http://trac.pc.com.cn/iphone/wiki/pcauto_BuyAuto_1.0.0#a2.6.1.团购-团购列表含筛选
2.1 车型库
2.1.1.车型库-品牌列表
备注：获取车型库品牌列表
请求URL： http://mrobot.pcauto.com.cn/v2/price/brands
请求后端URL： http://price.pcauto.com.cn/interface/iphone/brand_list.jsp,
HTTP请求方式：get
是否需要登录：否
返回格式：json
缓存方式：无
缓存时间：1天
请求参数：无
2.1.2.车型库-品牌-车系列表
备注：通过品牌ID得到车系列表
请求URL： http://dev3.pcauto.com.cn:8001/interface/iphone/serialGroup_list_v2.jsp?bid=1&type=1
HTTP请求方式：get
是否需要登录：否
返回格式：json
缓存方式：无
缓存时间：5分钟
请求参数：
| 参数名 | 类型 | 必须 | 说明 |
| bid | number | YES | 品牌id |
返回参数，需要增加一个字段：
{
"manufacturers":[
{
"brandName":"奥迪",
"name":"一汽奥迪",
"brandIntroduction":"http://price.pcauto.com.cn/qcbk/ppgs/Audi/1208/2068630.html",
"serials":[
{
"id":3524,
"name":"奥迪A4L",
"kind":"中型车",
"priceRange":"27.28~57.81 万",
"isNew":0,
"sellStatus":3,
"photo":"http://www1.pcauto.com.cn/piclib/20000/nEO_IMG_3524.jpg",
"count":41
},...]
}...]
}
2.1.3.车型库->车系->车型列表
备注：通过车系ID得到车型列表
请求URL： http://mrobot.pcauto.com.cn/v3/price/getModelListBySerialId_v4/3524
HTTP请求方式：get
是否需要登录：否
返回格式：json
缓存方式：无
缓存时间：5分钟
请求参数：
| 参数名 | 类型 | 必须 | 说明 |
| bid | number | YES | 品牌id |
返回参数，需要增加一个字段：
2.1.4.车型库-热销排行榜
备注：
请求URL： http://dev3.pcauto.com.cn:8001/interface/iphone/praiselist_by_kindId.jsp?kindId=1&pageNo=1&pageSize=10
HTTP请求方式：get
是否需要登录：否
返回格式：json
缓存方式：无
缓存时间：无
请求参数
| 参数名 | 类型 | 必须 | 说明 |
| kindId | number | 是 | 1~8分别代表：紧凑型车、SUV、中型车、小型车、微型车、中大型车、豪华型车、MPV |
| page | number | 是 | 请求分页 |
| pagesize | number | 是 | 请求分页大小 |
返回参数
{
"total":146,
"list":[
{
"price":"12.38-16.08万",
"serialGroupId":"2734",
"serialGroupName":"卡罗拉",
"photo":"http://www1.pcauto.com.cn/piclib/20000/nEO_IMG_2734.jpg"
},...]
}
2.1.4.车型库-搜索-关键词
备注：动态获取搜索关键字，由编辑在cms里维护
请求URL： http://mrobot.pcauto.com.cn/v3/price/modelsForSearch
请求后端URL： http://www.pcauto.com.cn/client/news/tghd/1401/intf2907.js
HTTP请求方式：get
是否需要登录：否
返回格式：json
缓存方式：无
缓存时间：无
请求参数：无
返回参数：
{
"modelList": [{
"id": 123,
"name": "蒙迪欧"
}]
}
2.1.5 车型库-车系搜索
备注：
请求URL： http://mrobot.pcauto.com.cn/v3/price/models/search?keyword=大众&pageNo=1&pageSize=1000
请求后端URL： http://price.pcauto.com.cn/interface/iphone/search_serial_group_list.jsp?pageNo=1&pageSize=1000&keyword=大众
HTTP请求方式：get
是否需要登录：否
返回格式：json
缓存方式：无
缓存时间：无
请求参数:
| 参数名 | 类型 | 必须 | 说明 |
| keyword | string | YES | 查询条件 |
| pageNo | number | YES | 页码 |
| pageSize | number | YES | 一页条数 |
2.2 车系
2.2.1.车系-综述
备注：
请求URL： 待定
HTTP请求方式：get
是否需要登录：否
返回格式：html页面
缓存方式：无
缓存时间：无
请求参数
| 参数名 | 类型 | 必须 | 说明 |
| seriesid | string | 是 | 车系id |
| areaId | string | 是 | 用户所在城市 |
| 返回参数 | |||
| 参数名 | 类型 | 必须 | 说明 |
| - | - | - | - |
页面内协议说明
| 协议串 | 说明 |
| pcautobuy://serial-activity-detail/?serialid=xx | 去团购 |
| pcautobuy://serial-activity-initiate/?serialid=xx | 发起团购 |
| pcaction://serial-subscribe/?serialid=xx | 订阅 |
| pcaction://serial-un-subscribe/?serialid=xx | 取消订阅 |
| pcaction://model-compare/?model=xx | 对比 |
2.2.2.车系-优惠
http://trac.pc.com.cn/iphone/wiki/pcauto_BuyAuto_1.0.0#a2.5优惠
2.2.3.车系-参配
备注：
请求URL： 待定
HTTP请求方式：get
是否需要登录：否
返回格式：html页面
缓存方式：无
缓存时间：无
请求参数
| 参数名 | 类型 | 必须 | 说明 |
| seriesid | string | 是 | 车系下所有车型id串串，通过逗号隔开，如：1，2，3 |
页面内协议说明
| 协议串 | 说明 |
| pcautobuy://commont-detail/?serialid=xx&commonid=xx | 点击点评列表项的跳转uri |
2.2.4.车系-点评
备注：（资讯客户端的车主点评列表）获取某车系下的车主点评列表。接口为网页，点击网页中列表，跳转协议为：pcaction://pcauto-owner-review?modelId=${id}
请求URL： http://mrobot.pcauto.com.cn/v3/price/commentList/{serialId}
HTTP请求方式：get
是否需要登录：否
返回格式：html页面
缓存方式：无
缓存时间：无
请求参数：
serialId：车系id
night：晚间模式（传值时，传日间模式)
请求后端URL：
http://price.pcauto.com.cn/interface/iphone/commentList_by_sgid.jsp?sid=3404&pageNo=1&pageSize=10
请求后端参数：
sid：车系id（从id_0中取出）
pageNo：第几页
pageSize：每页显示多少条
2.2.5.车系-资讯
备注：（（现有接口，每个tab，请求不同的url，之所以弄出来，是想做个整合后的））
请求URL： 待定
HTTP请求方式：get
是否需要登录：否
返回格式：json
缓存方式：无
缓存时间：无
请求参数
| 参数名 | 类型 | 必须 | 说明 | |
| seriesid | string | 是 | 车系id | |
| page | number | 是 | 分页页码 | |
| pagesize | number | 是 | 分页大小 | |
| infotype | number | 是 | 资讯类型：0、全部、1、新闻 2、评测 3、导购 4、行情 | |
| 返回参数 | ||||
| 参数名 | 类型 | 必须 | 说明 | |
| total | number | yes | 资讯总个数 | |
| list | array | yes | 资讯列表分页数据 | |
| 列表项格式 | ||||
| 参数名 | 类型 | 必须 | 说明 | |
| infoid | string | 是 | 文章id | |
| thumb | string | 是 | 文章缩略图 | |
| title | string | 是 | 文章标题 | |
| type | string | 是 | 文章类型 | |
| date | string | 是 | 文章时间 |
2.3 车型
2.3.1.车型-综述
备注：
请求URL： 待定
HTTP请求方式：get
是否需要登录：否
返回格式：html页面
缓存方式：无
缓存时间：无
请求参数
| 参数名 | 类型 | 必须 | 说明 |
| modelid | string | 是 | 车系id |
| 返回参数 | |||
| 参数名 | 类型 | 必须 | 说明 |
页面内协议说明
| 协议串 | 说明 |
| pcautobuy://model-activity-detail/?modelid=xx | 去团购 |
| pcautobuy://model-activity-initiate/?modelid=xx | 发起团购 |
| pcaction://model-subscribe/?modelid=xx | 订阅 |
| pcaction://model-un-subscribe/?modelid=xx | 取消订阅 |
| pcaction://model-compare/?model=xx | 对比 |
2.3.2.车型-参配
备注：
请求URL： 待定
HTTP请求方式：get
是否需要登录：否
返回格式：html页面
缓存方式：无
缓存时间：无
请求参数
| 参数名 | 类型 | 必须 | 说明 |
| modelid | string | 是 | 车系id |
| 返回参数 | |||
| 参数名 | 类型 | 必须 | 说明 |
| - | - | - | - |
| 页面内协议说明 | |||
| 参数名 | 类型 | 必须 | 说明 |
| - | - | - | - |
2.3.3.车型-点评（资讯客户端的车主点评）
备注：车主点评终端页
请求URL：http://mrobot.pcauto.com.cn/v3/price/commentDetail/{modelId}
v4.3之后请使用如下url：
http://mrobot.pcauto.com.cn/v3/price/commentDetail/{modelId}?userId=123&isShow=0
HTTP请求方式：get
是否需要登录：否
返回格式：html页面
缓存方式：无
缓存时间：无
请求参数：
车型id
userId： 用户id
isShow：0，不显示车型名称；1，显示车型名称
阅读模式：无参数 白天；night 晚间（传值时，传日间模式)
请求后端URL：
http://price.pcauto.com.cn/interface/iphone/detail_comment_owner.jsp?mid=19799
http://price.pcauto.com.cn/interface/iphone/model_detail.jsp?mid=19799
http://price.pcauto.com.cn/interface/iphone/model_list_v3.jsp //其他车型
请求后端参数：
mid：车型id（从id_0取出）
2.3.4.车型-团购/陪购
备注：
请求URL： 待定
HTTP请求方式：get
是否需要登录：否
返回格式：html页面
缓存方式：无
缓存时间：无
请求参数
| 参数名 | 类型 | 必须 | 说明 |
| modelid | string | 是 | 车系id |
| 返回参数 | |||
| 参数名 | 类型 | 必须 | 说明 |
| - | - | - | - |
| 页面内协议说明 | |||
| 参数名 | 类型 | 必须 | 说明 |
| - | - | - | - |
2.3.5.车型-优惠详情
备注：
请求URL： 待定
HTTP请求方式：get
是否需要登录：否
返回格式：html页面
缓存方式：无
缓存时间：无
请求参数
| 参数名 | 类型 | 必须 | 说明 |
| modelid | string | 是 | 车系id |
| 返回参数 | |||
| 参数名 | 类型 | 必须 | 说明 |
| - | - | - | - |
| 页面内协议说明 | |||
| 参数名 | 类型 | 必须 | 说明 |
| - | - | - | - |
2.4 找车
2.4.1. 筛选-精准选车条件
备注：
请求URL： http://dev3.pcauto.com.cn:8001/interface/iphone/price_choose_option.jsp
HTTP请求方式：get
是否需要登录：否
返回格式：json
缓存方式：无
缓存时间：无
请求参数：无
返回参数说明：
1、级别-jb => 76-微型车（详细信息请参考接口数据） 2、排量-pl 3、变速箱-bsx 4、结构-mkid 5、国别-country 6、燃料-rl 7、座位-zw 8、驱动-qdfs 9、自定义价格 最低价-ps 10、自定义价格 最高价-pe
2.4.2. 筛选-快速查找符合条件个数/列表
备注：筛选条件变后，自动获取符合筛选条件的车型个数
1、用来请求找车首页的筛选条件
2、支持关联筛选，当用户的选择条件变更时，需要重新请求，请求的返回数据中：fact字段中，列出了每个筛选条件的可选值
3、isHasList用来区分请求个数还是请求列表
请求URL： http://dev3.pcauto.com.cn:8001/interface/iphone/query_car.jsp
HTTP请求方式：get
是否需要登录：否
返回格式：json
缓存方式：无
缓存时间：无
请求参数：无
| 参数名 | 类型 | 必须 | 说明 |
| rid | string | 是 | 用户所在地区id |
| isHasList | string | 是 | 筛选个数、筛选列表 |
| ps | string | 否 | 最小价格 |
| pe | string | 否 | 最大价格 |
| jb | string | 否 | 级别 |
| pl | string | 否 | 排量 |
| bsx | string | 否 | 变速箱 |
| jg | string | 否 | 结构 |
| gb | string | 否 | 国别 |
| rl | string | 否 | 燃料 |
| zw | string | 否 | 座位 |
| qd | string | 否 | 驱动 |
| pzs | string | 否 | 配置 |
| pageNo | string | 否 | 分页 |
| pageSize | string | 否 | 分页大小 |
2.5 优惠
2.5.1. 优惠-优惠列表
正式环境URL：
http://price.pcauto.com.cn/dealer/interface/app/market_groupby_model_json.jsp
测试环境URL：
http://dev3.pcauto.com.cn:8001/dealer/interface/app/market_groupby_model_json.jsp
HTTP请求方式：get
返回格式：json
请求参数
areaId：城市id [[BR]] mfId: 厂商id [[BR]] sgId: 车系id [[BR]] modelId：车型id [[BR]] pageNo：第几页 [[BR]] pageSize：每页大小 [[BR]] callback：js回调函数名称 [[BR]]
返回结果
{
total: 143, //团购总数
pageCount: 15, //团购总页数
pageNo: 1, //第几页
pageSize: 10, //每页大小
models: [ //活动信息列表
{
modelId: 7616, //车型id
price: 7.78, // 车型官方价
name: "锐欧 2007款 1.4 手动 豪华型", //车型名称
discountPrice: 5.78, //促销价
discount : 20000, //降幅
dealers:[
{
dealerId : 32046, // 经销商ID
name : 庞大东风悦达起亚, // 经销商简称
price : 7.78, //车型官方价
discountPrice: 5.78, //行情促销价
discount : 20000, //降幅
dealerPrice : 7.78, // 经销商报价
is4S : 1, // 是否4S店，1：是，0：否
is400 : 1, // 是否400电话，1：是，0：否
phone : 400-670-5680, //电话
namelistRange : 1 // 销售范围，0:本市，1:本省，2:全国
},
...
]
},
...
]
}
2.6 团购
2.6.1. 团购-团购列表(含筛选)
备注：
请求URL：
{{{正式环境URL： http://mai.pcauto.com.cn/gct/interface/get_gct_activity_list.jsp?regionId=1
测试环境URL： http://dev3.pcauto.com.cn:9977/gouchetuan/interface/get_gct_activity_list.jsp?regionId=1
}}}
HTTP请求方式：get
是否需要登录：否
返回格式：json
缓存方式：无
缓存时间：无
请求参数
| 参数名 | 类型 | 必须 | 说明 |
| seriesid | string | 否 | 筛选条件，如果全部车型，则为空，多个车系的情况，以，号隔开 |
| regionId | string | 是 | 城市id |
| provinceId | string | 是 | 省份id |
| manufacturerId | string | 否 | 品牌id |
| page | number | 是 | 请求分页 |
| pagesize | number | 是 | 请求分页大小 |
| 返回示例 |
{
total: 143, //团购总数
pageCount: 15, //团购总页数
pageNo: 1, //第几页
pageSize: 10, //每页大小
data: [ //活动信息列表
{
id: 4702, //团购活动id
person: 7, //参加团购活动人数
title: "别克厂家直销会 百万钜惠让利等你来", //团购活动标题
price: "17.5", //显示价格
image: "HYPERLINK "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1310/28/c19/28064316_1382955211312_350x260.jpg"http://img.pconline.com.cn/images/upload/upc/tx/auto5/1310/28/c19/28064316_1382955211312_350x260.jpg", //车系图片
serialName: "君威", //车系名称
deadline: "2014-08-02", //截止时间
discount: "25000" //优惠价格
},
...
]
}
2.6.3. 团购-活动详细
请求URI：（待定）
HTTP请求方式：get
返回格式：html
请求参数
| 参数名 | 类型 | 必须 | 说明 |
| tsgId | number | YES | 团购活动id |
web页面数据后端请求接口：
正式环境URL：http://mai.pcauto.com.cn/gct/interface/get_gct_activity_detail.jsp?tsgId=4702 测试环境URL：http://dev3.pcauto.com.cn:9977/gouchetuan/interface/get_gct_activity_detail.jsp?tsgId=141
后端返回参数
{
"models":[ //团购活动车型列表
{"modelId":28740, //车型id
"modelName":"君威 2014款 1.6T 时尚技术型", //车型名
"price":19.989999771118164, //车型价格
"discountPrice":17.489999771118164, //车型优惠价
"discount":2.5 //车型优惠幅度
},...],
"id":4702, //团购活动id
"dealerId":15964, //经销商id
"person":7, //活动参与人数
"title":"别克厂家直销会 百万钜惠让利等你来", //活动标题
"activityInfo":"...", //活动详情
"serialId":3543, //车系id
"image":"http://img.pconline.com.cn/images/upload/upc/tx/auto5/1310/28/c19/28064316_1382955211312_350x260.jpg", //车系图片
"serialName":"君威", //车系名
"deadline":"2014-08-02", //截止时间
"grouponInfo":[ //团购信息列表
{"text":"2000豪礼，1000元油卡等着你","name":"现场抽奖"},
{"text":"18期0利率，2-3年低利率","name":"贷款优惠"}
],
"city":"广东 广州" //活动城市
}
2.6.3. 团购报名接口信息
HTTP请求方式：post
返回格式：html
请求参数：
web后端请求接口：
正式环境URL：（注：正式环境的报名数据会派发给经销商，测试开发过程慎用） http://mai.pcauto.com.cn/gct/action/do_order.jsp?req-enc=utf-8
测试环境URL： http://dev3.pcauto.com.cn:9977/gouchetuan/action/do_order.jsp?req-enc=utf-8
| 参数名 | 类型 | 必须 | 说明 |
| modelId | number | YES | 车型id |
| userName | string | YES | 报名人名称 |
| phone | string | YES | 报名人电话 |
| dealerId | string | YES | 经销商id |
| tsgId | string | YES | 团购活动id |
| regionId | string | YES | 城市id |
| provinceId | string | YES | 省份id |
| origin | string | YES | 平台来源,0:未知,1:web,2:wap,3:IOS,4:Android,5:WP,6:杂志 |
| referer | string | YES | 来源URL（当前页面的url） |
后端web接口返回参数
{
code:200 //报名成功
}
204 - 表单必填参数不完整
205 - 活动结束，不能报名
206 - 活动未审核，不能报名
207 - 活动审核失败，不能报名
500 - 系统错误
2.7 我的
2.7.1. 我的-订阅列表
本地保存的数据-无接口
2.7.2. 我的-团购列表
本地保存的数据-无接口
2.7.3. 我的-陪购列表
本地保存的数据-无接口
2.7.4. 我的-消息推送定制
备注：
请求URL： 待定
HTTP请求方式：get
是否需要登录：否
返回格式：json
缓存方式：无
缓存时间：无
请求参数
| 参数名 | 类型 | 必须 | 说明 |
| devicestoken | string | 是 | 设备push消息对应的token值 |
| switch | bool | 是 | 是否接收push消息 |
| distubmode | bool | 是 | 夜间勿扰模式 |
| channels | string | 否 | 团购、陪购、优惠的内容定制，定制：1，不定制：0，如3个都定制的情况，传:1,1,1，只定制团购，其他不定制，传：1,0,0 |
| 返回参数 | |||
| 参数名 | 类型 | 必须 | 说明 |
| code | number | 是 | 消息定制结果码，0：成功，其他失败 |
| msg | string | 是 | 错误的情况下的，错误信息 |
2.8 工具
2.8.1. 购车计算器/车险计算器
备注：经与接口讨论，web端同事建议本地计算
2.9 图集
2.9.1. 车系/车型图片筛选条件（已有接口）
请求URL:http://mrobot.pcauto.com.cn/v2/price/pictureConditions?serialId=3404
http://mrobot.pcauto.com.cn/v2/price/pictureConditions?modelId=26593
HTTP请求方式：get
是否需要登录：否
返回格式：json
缓存方式：无
缓存时间：1小时
请求参数：serialId： 车系id，必填
modelId： 车型id，可选，当modelId不为0时，返回参数的models字段为空数组
返回参数：
{
"models":[
{
"id":123,
"modelName":""
}
],
"types":[
{
"id":1,
"typeName":"外观"
}
],
"colors":[
{
"id":1,
"colorName":""
}
]
}
请求后端URL：
http://price.pcauto.com.cn/interface/iphone/photo_choose_option.jsp
2.9.2. 车系/车型图片筛选查询（已有接口）
请求URL: http://mrobot.pcauto.com.cn/v2/price/pictures?serialGroupId=3404&modelId=26593&colorId=16133&typeId=1
HTTP请求方式：get
是否需要登录：否
返回格式：json
缓存方式：无
缓存时间：1小时
请求参数：
serialId：车系id
modelId：车型id
typeId：图片类型id
colorId：颜色id
pageNo：第几页
pageSize：每页显示多少条
返回参数：
{
"data": [
{
"bigPath": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1308/08/c4/24272527_1375932203312_500.jpg",
"smallPath": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1308/08/c4/24272527_1375932203312_120x90.jpg"
},
{
"bigPath": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1308/08/c4/24272527_1375932206296_500.jpg",
"smallPath": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1308/08/c4/24272527_1375932206296_120x90.jpg"
},
{
"bigPath": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1308/08/c4/24272527_1375932209296_500.jpg",
"smallPath": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1308/08/c4/24272527_1375932209296_120x90.jpg"
},
{
"bigPath": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1308/08/c4/24272527_1375932212468_500.jpg",
"smallPath": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1308/08/c4/24272527_1375932212468_120x90.jpg"
},
{
"bigPath": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1308/08/c4/24272527_1375932215640_500.jpg",
"smallPath": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1308/08/c4/24272527_1375932215640_120x90.jpg"
},
{
"bigPath": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1308/08/c4/24272527_1375932218718_500.jpg",
"smallPath": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1308/08/c4/24272527_1375932218718_120x90.jpg"
}
],
"pageCount": 4,
"pageNo": 1,
"pageSize": 6,
"total": 19
}
请求后端URL：
http://price.pcauto.com.cn/interface/iphone/photo_page_list.jsp
2.9.3. 车系/车型 全部图片查询（不用开发，等待下一版本设计）
请求URL: 待开发
HTTP请求方式：get
是否需要登录：否
返回格式：json
缓存方式：无
缓存时间：1小时
请求参数：
serialId：车系id
modelId：车型id
返回参数：
{
[
{
"groupid":23,// 图片分类id
"name":"外观",
"total":1024,
"pictures":[// 只返回6张
{
"bigPath": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1308/08/c4/24272527_1375932218718_500.jpg",
"smallPath": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1308/08/c4/24272527_1375932218718_120x90.jpg"
},
{
"bigPath": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1308/08/c4/24272527_1375932218718_500.jpg",
"smallPath": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1308/08/c4/24272527_1375932218718_120x90.jpg"
}
...
]
},
...
]
}
