| Version 8 (modified by oujianqiang, 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 必填参数:参数名=xxx(多种情况用括号解析) 非必填参数:参数名=xxx(多种情况用括号解析) 说明文档参数:添加某特定参数可以直接看接口文档 是否需要登录:是,否 返回格式:json,ssi,xml 缓存方式:接口缓存(接口中返回的响应头里面的 Cache-Control),对象缓存() 缓存时间:缓存时间 返回结果:结果可能情况
2.接口列表
2.1 找车
2.1.1. 筛选-快速查找符合条件个数/列表
说明:此接口是在前版本的基础上新增了sortType的请求参数,指示返回结果的排序方式
备注:筛选条件变后,自动获取符合筛选条件的车型个数
1、用来请求找车首页的筛选条件
2、支持关联筛选,当用户的选择条件变更时,需要重新请求,请求的返回数据中:fact字段中,列出了每个筛选条件的可选值
3、list用来区分请求个数还是请求列表
Mrobot请求URL: http://mrobot.pcauto.com.cn/buy/price/search?rid=1&list=true&jb=72&pageSize=20&pageNo=1
后端请求测试URL: http://v17.pcauto.com.cn:8002/interface/iphone/query_car.jsp
后端请求正式URL:
HTTP请求方式:get
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:无
请求参数:无
| 参数名 | 类型 | 必须 | 说明 |
| rid | string | 是 | 用户所在地区id |
| list | string | 是 | 筛选个数、筛选列表,取值true/false |
| ps | string | 否 | 最小价格 |
| pe | string | 否 | 最大价格 |
| jb | string | 否 | 级别 |
| pl | string | 否 | 排量 |
| bsx | string | 否 | 变速箱 |
| mkid | string | 否 | 结构 |
| country | string | 否 | 国别 |
| rl | string | 否 | 燃料 |
| zw | string | 否 | 座位 |
| qdfs | string | 否 | 驱动 |
| pz | string | 否 | 配置 |
| pageNo | string | 否 | 分页 |
| pageSize | string | 否 | 分页大小 |
| sortType | string | 否 | 排序方式,1:按热度, 2:按价格由高到低,3:按价格由低到高,默认值为1 |
2.2 优惠
2.2.1. 优惠-优惠列表
说明:此接口与前版本区别在于,在返回结果的models成员元素中新增了几个字段,分别是giftPackage(礼包优惠),modelType(现车情况)
Mrobot请求URL: http://mrobot.pcauto.com.cn/buy/price/promotionList?areaId=1&pageSize=20&pageNo=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?pageNo=1&pageSize=10&areaId=3
HTTP请求方式:get
返回格式:json
请求参数
areaId:城市id mfId: 厂商id sgId: 车系id modelId:车型id pageNo:第几页 pageSize:每页大小 callback:js回调函数名称
返回结果
{
total: 143, //团购总数
pageCount: 15, //团购总页数
pageNo: 1, //第几页
pageSize: 10, //每页大小
models: [ //活动信息列表
{
modelId: 7616, //车型id
price: 7.78, // 车型官方价
name: "锐欧 2007款 1.4 手动 豪华型", //车型名称
discountPrice: 5.78, //促销价
discount : 20000, //降幅
giftPackage : "送10000元礼包", //礼包优惠
modelType : "现车充足", //现车情况
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.3 团购活动
2.3.1 团购活动列表
(接口未上线,请连192.168.21.94:8888进行测试)
请求mrobot接口:http://mrobot.pcauto.com.cn/buy/price/activityListv11?pageNo=1&pageSize=1®ionId=3
应用端接口:http://dev3.pcauto.com.cn:9977/autoMall/interface/auto_mall_gct_list_json.jsp?regionId=3
请求参数:
regionId:城市ID(必须,默认值1)
manufacturerId:车厂ID(可选)
pageNo:页码(默认1)
pageSize:每页条数(默认20)
返回结果:
{
"data": [
{
"banner": "http://img.pconline.com.cn/images/upload/upc/tx/tuangou/1411/14/c0/34350_1415973025778_500x200.jpg", //购车团主图500x200px
"beginTime": "2014/11/14 00:00:00", //开始时间
"brandName": "凯迪拉克(进口)", //车厂名称
"endTime": "2014/12/12 23:59:59", //结束时间
"id": 349, //购车团ID
"maxDiscount": 5, //最高优惠,单位万.
"orderCount": 2, //活动报名人数
"photo": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1403/18/c3/32200468_1395112948222_180x135.jpg", //最大优惠车系主图,180x135像素
"priceTitle": "最高优惠", //价格标题
"serialGroupNames": "凯迪拉克SRX", //车系名称串(最多5个)
"title": "凯迪拉克厚惠无欺 万元优惠超值惊喜", //购车团标题
"url": "http://dev3.pcauto.com.cn:9977/gct/r3/g349/" //购车团链接
}
],
"pageCount": 14, //总页数
"pageNo": 1, //页码
"pageSize": 1, //页面条数
"total": 14 //总条数
}
2.3.2 发起团购
原接口:http://mai.pcauto.com.cn/gct/action/do_order.jsp?req-enc=utf-8
2.3.3 团购活动详情页
原接口:http://mrobot.pcauto.com.cn/v3/price/activityDetail/
Attachments
-
汽车报价宝典线索入口来源对应参数表(重要).txt
(324 bytes) -
added by oujianqiang 11 years ago.
汽车报价宝典线索入口来源对应参数表(重要)
![(please configure the [header_logo] section in trac.ini)](http://www1.pconline.com.cn/hr/2009/global/images/logo.gif)