| Version 136 (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
正式请求URL: http://price.pcauto.com.cn/interface/iphone/serialGroup_list_v2.jsp?bid=3&type=1
Mrobot请求URL: http://mrobot.pcauto.com.cn/v3/price/getSerialListByBrandId/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
正式URL: http://price.pcauto.com.cn/interface/iphone/praiselist_by_kindId.jsp?kindId=3&pageNo=1&pageSize=10
Mrobot正式URL: http://mrobot.pcauto.com.cn/buy/price/hotSellSerials/1?pageNo=1&pageSize=20
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.1.6 车型库-根据车型id查询车型详细
备注:
请求URL: http://dev3.pcauto.com.cn:8001/interface/iphone/model_message.jsp?modelId=26075&callback=getData
请求后端URL:
HTTP请求方式:get
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
| 参数名 | 类型 | 必须 | 说明 |
| modelId | string | YES | 车型id |
| callback | number | NO | 为解决js跨域问题,可不传 |
返回参数:
{
id = 21804; // 车型id
kind = "\U4e2d\U578b\U8f66"; // 所属车系的车系类型(如紧凑型、xx型等)
photo = "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1312/30/c19/30133161_1388384673038_120x90.jpg"; // 车型图片
price = "29.1"; // 车型价格
serialId = 3524; // 所属车系车系id
serialName = "\U5965\U8feaA4L"; // 所属车系名称
serialSubName = "\U4e00\U6c7d\U5965\U8fea"; // 所属车系的车系品牌(如:一汽大众、一汽奥迪、AC宝马)
modelName = "2013\U6b3e 1.8 30TFSI \U81ea\U52a8\U8212\U9002\U578b"; // 车型名称
}
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.车系-资讯
请求URL: http://mrobot.pcauto.com.cn/buy/price/getArticlesBySerialId/{serialId}?pageNo=1&pageSize=20&type=0
HTTP请求方式:get
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:无
请求参数
| 参数名 | 类型 | 必须 | 说明 | |
| serialId | string | 是 | 车系id | |
| page | number | 是 | 分页页码 | |
| pagesize | number | 是 | 分页大小 | |
| type | number | 是 | 资讯类型:0、全部、1、评测 2、导购 | |
| 返回参数 | ||||
| 参数名 | 类型 | 必须 | 说明 | |
| total | number | yes | 资讯总个数 | |
| data | array | yes | 资讯列表分页数据 | |
| 列表项格式 | ||||
| 参数名 | 类型 | 必须 | 说明 | |
| id | string | 是 | 文章id | |
| image | string | 是 | 文章导读图 | |
| title | string | 是 | 文章标题 | |
| channelName | string | 是 | 栏目名 | |
| pubDate | 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
正式URL: http://price.pcauto.com.cn/interface/iphone/price_choose_option.jsp
Mrobot正式URL: http://mrobot.pcauto.com.cn/buy/price/chooseOption
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、list用来区分请求个数还是请求列表
请求URL: http://dev3.pcauto.com.cn:8001/interface/iphone/query_car.jsp
Mrobot请求URL: http://mrobot.pcauto.com.cn/buy/price/search?rid=1&list=true&jb=72&pageSize=20&pageNo=1
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 | 否 | 分页大小 |
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
Mrobot请求URL: http://mrobot.pcauto.com.cn/buy/price/promotionList?areaId=1&pageSize=20&pageNo=1
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.5.2. 优惠-详细
获取优惠详情数据
请求地址:
测试: http://dev3.pcauto.com.cn:8001/dealer/interface/app/dealer_market_json.jsp
正式: http://price.pcauto.com.cn:/dealer/interface/app/dealer_market_json.jsp
请求参数:marketId 商家行情id
返回数据格式:
{
“deadline”:”2014-04-30”, //截止日期
“isShow24Icon”:””, // 是否24小时营业, 1:是,0:否
“is400”:1, // 是否400电话,1:是,0:否
“phone”:”123456” ,//电话
“discountInfo”:{
"dealerId": "2014.04.09-2014.04.30", // 经销商ID
"expiry": "2014.04.09-2014.04.30", //有效期
"shortInfo": "", //短标题
"info": "进口大众广州鸿众店内高尔夫(进口)现车充足,近期购车最高优惠10万。",
},
"models": [
{
"modelId": "高尔夫(进口) 2012款 1.4T 舒适敞篷版",
"modelName": "高尔夫(进口) 2012款 1.4T 舒适敞篷版",
"price": "34.98万", //官方价
"nowPrice": "24.98万", //现价
"discount": "10万", //降幅
"quantity": "充足", // 车型数量情况
"isReplace": "0", //是否含旧车优惠,1:是,0:否
"decline": "", // 行情优惠降幅
},
......
],
addModels:[
{
"modelId": "" //加装车id
"modelName": "", //加装车名称
"price": "", //加装车车型的官方价
"addPrice": "", //加装车售价
"config": "{addConfig: , otherConfig: }", //加装车配置
},
......
]
"images": [
"http://img.pconline.com.cn/images/upload/upc/tx/auto5/1305/21/c1/21155361_1369114292031_500.jpg",
"http://img.pconline.com.cn/images/upload/upc/tx/auto5/1305/21/c1/21155361_1369114385703_270x202.jpg"
]
}
2.5.3. 推荐经销商
获取推荐经销商(公共询价报名页)
正式环境URL:(已上线)
HYPERLINK "http://price.pcauto.com.cn/dealer/interface/order/recommend_dealer.jsp" http://price.pcauto.com.cn/dealer/interface/order/recommend_dealer.jsp
测试环境URL:
HYPERLINK "http://dev3.pcauto.com.cn:8001/dealer/interface/order/order_info.jsp" http://dev3.pcauto.com.cn:8001/dealer/interface/order/recommend_dealer.jsp
HTTP请求方式:get
返回格式:json
请求参数
rid:城市ID【必填】
sgid:车系id【必填】
type: 名单类型(询价报名固定为0即可)【必填】
callback:回调函数
返回结果
[
{
"vip":-1,
"dealerId":55342,
"phone":"400-881-0693",
"isShow24Icon":1,
"areaName":"龙华新区",
"range":0,
"phoneType":1,
"address":"龙华新区金龙路(梅林关口)上河坊购物乐园首层国汽名车广场",
"name":"深圳国汽宝马",
"agent":"4S店"
}...
]
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
Mrobot请求URL: http://mrobot.pcauto.com.cn/buy/price/activityList?regionId=1&pageSize=20&pageNo=1
HTTP请求方式:get
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:无
请求参数
| 参数名 | 类型 | 必须 | 说明 |
| serialIds | 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. 团购报名接口信息
未上线
测试url : http://dev3.pcauto.com.cn:9002/interface/app/do_autobuyOrder.jsp
PS:团购活动ID测试环境请使用:61,91,137,142,151,161 .
参数描述:
@param callback 回调函数名,选填
@param dId 设备ID,必填
@param acId 团购活动ID,必填
@return json 例: {"msg":"报名成功!","result":true}
2.6.4. 三人行报名接口
正式环境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
HTTP请求方式:post
返回格式:json
请求参数
carSerialId:车系ID【必填】
userName:报名人名称【必填】
phone:报名人电话【必填】
regionId:城市id【必填】
provinceId:省份id【选填】
origin:平台来源,0:未知,1:web,2:wap,3:IOS,4:Android,5:WP,6:杂志【必填】
isInitMsg:1,【三人行报名,固定为1】
referer:来源URL(当前页面的url)【必填】(购车APP填写固定值:http://mrobot.pcauto.com.cn/autobuy/ 用于记录报名来源于购车app)
返回参数
{
code:200 //报名成功
}
204 - 表单必填参数不完整
500 - 系统错误
2.6.5. 团购投诉接口信息
说明:
使用post方式请求
测试请求url:
http://dev3.pcauto.com.cn:8001/dealer/interface/tuangou/tuangou_report.jsp?_charset=GBK
上线后请求url:
http://price.pcauto.com.cn/dealer/interface/tuangou/tuangou_report.jsp?_charset=GBK
参数:
name:投诉人姓名
phone:投诉人电话
content:投诉内容
callback:回调函数名称(可以不传,按具体情况使用)
返回值:
不传callback参数
成功返回:{"status":"success"}
失败返回:{"status":"error"}
传callback参数
成功返回:callback_name({"status":"success"})
失败返回:callback_name({"status":"error"})
2.6.5. 获取车系/车型最近30天4S店报名人数
获取车系/车型最近30天4S店报名人数
正式环境URL:(已上线)
HYPERLINK "http://price.pcauto.com.cn/dealer/interface/order/order_info.jsp" http://price.pcauto.com.cn/dealer/interface/order/order_info.jsp
测试环境URL:
HYPERLINK "http://dev3.pcauto.com.cn:8001/dealer/interface/order/order_info.jsp" http://dev3.pcauto.com.cn:8001/dealer/interface/order/order_info.jsp
HTTP请求方式:get
返回格式:json
请求参数
m:调用方法(getCountBySG:获取某个车系报名人数;getMCountBySG:获取某个车系下所有车型的报名人数)【必填】
sgId:车系id【必填】
callback:回调函数
返回结果
getCountBySG
[{"result":true,"count":30971,"msg":"报名人数获取成功"}]
getMCountBySG
[
{
"result":true,
"count":[
{
"modelId":12168,
"count":3
},
{
"modelId":11309,
"count":3
},
{
"modelId":11310,
"count":3
},
{
"modelId":12158,
"count":3
},
{
"modelId":27110,
"count":3
}
],
"msg":"报名人数获取成功"
}
]
2.7 我的
2.7.1. 我的-订阅列表
测试url : http://dev3.pcauto.com.cn:9002/interface/app/get_autobuyApp.jsp
参数描述:
@param callback 回调函数名,选填
@param m 调用的方法,必填,取值m=getFavorList : 获取我的爱车列表
@param dId 设备ID,必填
@param bt 报名-起始时间, 选填 格式为:yyyy-MM-dd 例:2014-08-11
@param et 报名-结束时间, 选填 格式为:yyyy-MM-dd 例:2014-08-11
@param page 分页,当前页数, 选填
@param size 分页,页面长度, 选填
json 例:
{"models":"1,360,518","serialgroups":"3424,4254"}
2.7.2. 我的-添加车型/车系订阅
未上线
测试url : http://dev3.pcauto.com.cn:9002/interface/app/do_autobuyApp.jsp
参数描述:
@param callback 回调函数名,可选
@param m 调用的方法,必填,m的取值,{m=modelFavor,serialgroupFavor},参数说明如下:
取值1,m=modelFavor : 车型 新增/取消 收藏
@param dId 设备ID,必填
@param mId 车型ID,必填
@param func 功能类型,必填,取值{add:新增收藏,cancle:取消收藏}
取值1,m=serialgroupFavor : 车系 新增/取消 收藏
@param dId 设备ID,必填
@param sgId 车系ID,必填
@param func 功能类型,必填,取值{add:新增收藏,cancle:取消收藏}
2.7.3. 我的-团购列表
未上线
测试url : http://dev3.pcauto.com.cn:9002/interface/app/get_autobuyOrder.jsp
参数描述:
@param callback 回调函数名,选填
@param m 调用的方法,必填,取值=getOrderList : 获取我的团购报名列表
@param dId 设备ID,必填
@param bt 报名-起始时间, 选填 格式为:yyyy-MM-dd 例:2014-08-11
@param et 报名-结束时间, 选填 格式为:yyyy-MM-dd 例:2014-08-11
@param page 分页,当前页数, 选填
@param size 分页,页面长度, 选填
@return json 例:
{
"data": [
{
"acId": 191, ##团购活动id
"deadline": "2014-08-06", ##活动截至时间
"discount": 0.20, ##优惠
"discountPrice": 11.07, ##优惠价
"image": " http://img.pconline.com.cn/images/upload/upc/tx/auto5/1406/25/c5/35654388_1403678285814_350x260.jpg", ##图像
"orderCount": 3, ##报名人数
"sgId": 8670, ##车系id
"sgName": "奥迪Q3", ##车系名
"title": "奥迪A4L 2013款 2.0 40TFSI quattro" ##活动标题
},{
...其他团购信息
}]
}
2.7.4. 我的-陪购列表
//1.0.0 本期不用做
2.7.4. 我的-消息推送定制
未上线
测试url : http://dev3.pcauto.com.cn:9002/interface/app/do_autobuyApp.jsp
参数描述:
@param callback 回调函数名,可选
@param m 调用的方法,必填,m的取值,{m= triggerSync},参数说明如下:
@param dId 设备ID,必填
@param push 开关值,必填 0:不推送, 1:推送
@param type 功能类型,必填,取值:1:推送总开关. 2:夜间推送开关. 3:团购推送开关. 4:优惠推送开关.
2.7.5. 我的-车库数据启动同步接口
测试url : http://dev3.pcauto.com.cn:9002/interface/app/do_autobuyApp.jsp 参数描述: @param callback 回调函数名,可选 @param m 调用的方法,必填,m=launchSync : 启动购车APP时同步: @param dId 设备ID,必填 @param app app名称,必填 @param mIds 车型收藏ids 英文","号相隔 , 必填.若无收藏可不传此参数.(DB会跟mIds的值完全同步) @param sgIds 车系收藏ids 英文","号相隔 , 必填.若无收藏可不传此参数.(DB会跟sgIds的值完全同步) @param token app标识,选填 @param rId 用户所在城市id,选填 @param rName 用户所在城市名称,选填 @param pushSwitch 推送总开关,选填 0:不推送, 1:推送 @param nightPushSwitch 夜间推送开关,选填 0:不推送, 1:推送 @param groupbuySwitch 团购推送开关,选填 0:不推送, 1:推送 @param discountSwitch 优惠推送开关,选填 0:不推送, 1:推送
2.7.8 根据车系/车型获取行情接口
正式地址:(已上线)
HYPERLINK "http://price.pcauto.com.cn/dealer/interface/app/model_news4fav_json.jsp" http://price.pcauto.com.cn/dealer/interface/app/model_news4fav_json.jsp
测试地址:
HYPERLINK "http://dev3.pcauto.com.cn:8001/dealer/interface/app/model_news4fav_json.jsp" http://dev3.pcauto.com.cn:8001/dealer/interface/app/model_news4fav_json.jsp
请求参数:
areaId 地区id
sgIds 车系id串,逗号分隔多个
modelIds 车型id串,逗号分隔多个
date 日期,格式:yyyy-MM-dd
callback js回调函数名称
返回值:
{
"sgNews":[
{
"newsCreateTime":"2014-08-18 09:04:19.0",
"newsUrl":"http://m.pcauto.com.cn/auto/market/30830-5319592.html",
"newsId":"5319592",
"newsName":"朗逸最高优惠0.5万 现车充足",
"sgId":"3225"
}
……
],
"modelNews":[
{
"newsCreateTime":"2014-08-18 09:04:19.0",
"newsUrl":"http://m.pcauto.com.cn/auto/market/30830-5319592.html",
"newsId":"5319592",
"newsName":"朗逸最高优惠0.5万 现车充足",
"modelId":"3225"
}
……
]
}
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"
}
...
]
},
...
]
}
![(please configure the [header_logo] section in trac.ini)](http://www1.pconline.com.cn/hr/2009/global/images/logo.gif)