=报价1.4.0接口文档 =
mrobot代理环境说明:
192.168.10.198 端口为 1080 连的是QA测试环境(192.168.74.80)
192.168.10.199 端口为 1080 连的是dev40的开发环境(192.168.75.40)
ps:对于mrobot.pcauto.com.cn/x/前缀的接口,mrobot仅作代理,没有任何逻辑处理。
1.首页焦点图/品牌数据接口
mrobot地址: http://mrobot.pcauto.com.cn/xsp/s/auto/buy/v1.4/homeData.xsp?rid=1
说明
返回首页焦点图/热门品牌数据
缓存时间
0
提交方式
GET
是否登录
否
数据来源
CMS: http://www.pcauto.com.cn/client/000089086/1512/intf8251.js
请求参数
| 参数名 | 参数含义 | 参数名 | 参数含义 |
|---|---|---|---|
| rid | 区域id |
返回
{
"state": 0,
"message": "成功",
"banner": [
{
"title": "广州专享,买车就送大礼,厚惠无期",
"link": "http://app.pcauto.com.cn/bjkclient/",
"picUrl": "http://img0.pcautost3.png",
"type": "1"
}
],
"brand": [
{
"id": 1,
"name": "name",
"logo": "logo"
}
]
}
录入需要注意与pc对应:
==================================link的内容按type不同区分====================================================================================
1.当type=2优惠列表link的内容是http://mrobot.pcauto.com.cn/xsp/s/auto/buy/v1.2/promotionList.xsp
pc对应http://price.pcauto.com.cn/market/r1/
2.当type=3时link的内容是pcaction://discount_detial/?marketId=1&carModeId=1 说明:marketId 优惠ID carModelId 车型ID
优惠详情:
pc对应http://price.pcauto.com.cn/market/33496-42626-11372135.html
经销商Id:33496
车型ID:42626
优惠ID:11372125
协议(link的内容)如下:pcaction://discount_detial/?marketId=优惠ID&carModeId=车型ID
3.当type=4团购列表,link的内容是 http://mrobot.pcauto.com.cn/buy/price/activityListv11
pc对应http://mall.pcauto.com.cn/gct/r1/
4.当type=5时,link的内容是内容是pcaction://active_detial/?activeId=1 说明activeId 团购ID
团购列表:
http://mall.pcauto.com.cn/gct/r1/
团购详情:
http://mall.pcauto.com.cn/gct/r1/g7521/
团购ID:7521
协议(link的内容)如下: pcaction://active_detial/?activeId=7521
测试环境:
优惠:dev3.pcauto.com.cn:8001/market/r1/
团购:v37.pcauto.com.cn/gct/r1/
返回参数说明
| 参数名 | 参数含义 | 参数名 | 参数含义 |
|---|---|---|---|
| status | 接口返回状态码:0成功,非0异常 | message | 接口返回描述信息 |
| title | 标题 | type | 跳转类型:1专题、2优惠tab列表、3优惠指定详情、4团购列表、5团购指定详情 |
| brand | 品牌id数组 | link | 链接地址 |
| picUrl | 图片地址 | picUrl | 图片地址 |
| id | 品牌ID | name | 品牌名称 |
| logo | 品牌logo图片地址 |
1.2销量排行榜
(mrobot开发已完成,请连开发机进行测试)
mrobot地址: http://mrobot.pcauto.com.cn/xsp/s/auto/buy/v1.4/hotSellSerials.xsp?year=2015&month=1&type=73
应用后端url: http://price.pcauto.com.cn/top/sales/s2-t73.html (获取销量排行榜)
http://price.pcauto.com.cn/interface/iphone/get_lower_modelPrice.jsp?vs=1.3&rid=1&sid=车系ID 取本地最低价数据接口
说明
缓存时间
0
提交方式
GET
是否登录
登录与未登录都可请求
数据来源
论坛
参数
| 参数名 | 参数含义 | 类型 | 是否必须 | 默认值 |
|---|---|---|---|---|
| type | 类别 | int | 是 | 73:紧凑车型,1:SUV,72:中型车,110:小型车,76:微型车,71:中大型车,74:MPV |
| pageNo | 第几页 | int | 是 | 1 |
| pageSize | 显示条数 | int | 是 | 20 |
| areaId | 区域 | int | 是 | 1 |
返回
{
"title": "SUV",
"serials": [
{
"total": 10229, //销售数量,最近一个月有数据
"allTotal":108956,//从一月起,销售总数
"smallPhoto": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1305/23/c7/21219427_1369289985326_400x300.jpg",//小图
"photo": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1305/23/c7/21219427_1369289985326.jpg",//大图
"brandId": 949,//品牌id
"brandName": "东风风行",//品牌名称
"price": "2.3",//本地最低
"photo_350x260": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1305/23/c7/21219427_1369289985326_350x260.jpg",//与原接口的photo字段尺寸一致
"serialGroupId": 7682,//车系id
"serialGroupName": "景逸SUV" //车系名称
}
}
1.3 搜索
mrobot地址:
Url: http://mrobot.pcauto.com.cn/xsp/s/auto/buy/v1.4/search.xsp?q=奔
后端Url: http://ks.pcauto.com.cn/searchSuggest2.shtml?q=%E7%A7%91&app=composite&addSFields=kind_name,photo
说明 车系搜索接口,仅搜索车系,过滤品牌搜索
搜索车系接口
缓存时间
0
提交方式
GET
是否登录
否
数据来源
mrobot后台
参数
| 参数名 | 参数含义 | 类型 | 是否必须 | 默认值 |
|---|---|---|---|---|
| q | 搜索关键字 | string | 是 | 无 |
返回
{
"status": "0",
"message": "操作成功",
"datas": [
{
"serialId": "3195",
"name": "天籁",
"photo": "http://img.pcauto.com.cn/images/upload/upc/tx/auto5/1505/28/c20/7570720_7570720_1432795429921.JPG",
"kind": "中型车",
"price": "17.78-29.98万"
},
]
}
返回参数说明
| 参数名 | 参数含义 | 类型 | 是否必须 | 说明 |
|---|---|---|---|---|
| status | 状态码 | string | 是 | 0->成功 |
| message | 提示信息 | string | 是 | 失败返回失败信息 |
| serialId | 车系id | int | 是 | 无 |
| name | 车系名称 | string | 是 | 无 |
| photo | 车系图片url | string | 是 | 无 |
| kind | 车系类型 | string | 是 | 无 |
| price | 车系价格 | string | 是 | 无 |
1.4 团购详情页
mrobot地址: http://mrobot.pcauto.com.cn/buy/price/activityDetailv11/5397?areaId=1&dId=111
说明
团购详情页接口
已修复团购状态异常的问题
缓存时间
0
提交方式
GET
是否登录
否
数据来源
mrobot后台
参数 团购详情id,拼接在url后面
返回: HTML
1.5 车系综述页接口
(mrobot开发已完成,请连开发机进行测试)
后端接口
http://price.pcauto.com.cn/interface/iphone/atom/price/serial_group_basic_json.jsp?serialGroupId=4313 //车系概述基本数据 http://price.pcauto.com.cn/interface/iphone/atom/price/model_list_by_sg_json.jsp?serialGroupId=4313 //车系概述最低价接口 http://price.pcauto.com.cn/interface/iphone/serial_group_compete.jsp?serialGroupId=4313&size=3 //车系对比 http://mall.pcauto.com.cn/autoMall/interface/auto_mall_gct_list_by_sg_json.jsp?regionId=3&serialId=4313 //判断是否有团购 http://price.pcauto.com.cn/interface/iphone/atom/dealer/model_list_news_price_json.jsp?serialGroupId4313&rId=3 //车系概述列表接口 http://price.pcauto.com.cn/interface/iphone/get_lower_modelPrice.jsp?rid=3&sid=4313) //获取本地最低价 http://price.pcauto.com.cn/interface/cms/region_400_json.jsp?rid=3) //获取400电话 http://price.pcauto.com.cn/dealer/interface/app/market_groupby_model_json.jsp?vs=1.3&areaId=1&isSubscribed=1&modelId=33393 //通过modelId去取对应的经销商的列表及基础数据
HTTP请求方式:get
是否需要登录:false
返回格式: html
缓存方式:
缓存时间:60
说明:
请求参数:
| 参数名 | 类型 | 必须 | 说明 |
| areaId | int | Y | 地区ID |
| serialId | int | Y | 车系id |
| isSubscribed | int | N | 是否订阅 |
| modelIds | int | N | 车型ID |
| inreview | int | Y | 是否审核 |
页面内数据说明:在返回的页面里添加了注释数据/*@_HTML_META_START_(数据部分)_HTML_META_END_@*/ 数据内容为:
{
"kind": "中型车",
"photo": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1408/11/c1/37285606_37285606_1407725980801_400x300.jpg",
"priceRange": "27.28~57.81万",
"cars": [{
"title": " 1.8T 涡轮增压 160马力",
"data": [{
"id": "33318",
"title": "2015款 1.8 30TFSI 手动舒适型",
"price": "27.28",
"config": "6挡手动 前置前驱 ",
"state": "在售",
"status": "在售",
"isNews": "0",
"rjBzzw": 5,
"introduce": 0,
"photo": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1409/17/c6/38686815_38686815_1410941571968_120x90.jpg",
"minPrice": "23.77",
"paiLiang": "1.8",
"jqx": 950,
"glassPercent": 0.0019,
"compared": "",
"result": {
"shoufu": 7.13,
"loan": 170000,
"monthPay": 0.52,
"firstPayTotal": 9.87,
"loantotal": 28.7,
"total": 26.87
}
}]
},
{
"title": " 2.0T 涡轮增压 224马力",
"data": [{
"id": "33319",
"title": "2015款 2.0 45TFSI quattro个性运动版",
"price": "35.3",
"config": "7挡双离合 前置四驱 托森式差速",
"state": "在售",
"status": "在售",
"isNews": "0",
"rjBzzw": 5,
"introduce": 0,
"photo": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1410/22/c6/39977239_39977239_1413950602832_120x90.jpg",
"minPrice": "31.42",
"paiLiang": "2.0",
"jqx": 950,
"glassPercent": 0.0019,
"compared": "",
"result": {
"shoufu": 9.43,
"loan": 220000,
"monthPay": 0.68,
"firstPayTotal": 13.41,
"loantotal": 37.77,
"total": 35.41
}
}
]
}]
}
协议说明:
订阅: pcautobuy://addSubscribed/?serialId={{serialId}}&serialName={{serialName}} 取消订阅:pcautobuy://deleteSubscribed/?serialId={{serialId}}&serialName={{serialGroupName}}
对比:pcaction://compare/?modelId={{id}}&modelName={{title}}&image={{photo}} 取消对比:pcaction://decompare/?modelId={{id}}&modelName={{title}}&image={{photo}}
去团购:pcautobuy://model-activity-detail/?activityId={{activityId}}&areaId={{areaId}} 求组团:pcautobuy://serial-activity-initiate/?serialId={{serialId}}&serialName={{serialGroupName}}
询底价:pcautobuy://auto-ask-price/?areaId={{areaId}}&dealerId=0&serialId={{serialId}}&modelId={{modelId}}&modelName={{modelName}}&image={{image}}&isMain=1
去购车计算:pcautobuy://auto-calculator/{{id}}?modelName={{title}}&price={{minPrice}}&paiLiang={{paiLiang}}&rjBzzw={{rjBzzw}}&introduce={{introduce}}
400电话咨询:pcaction://webview_tel/{{phone}}?name={{name}}
我要优惠:pcautobuy://auto-get-promotion/?areaId={{param.areaId}}&dealerId={{dealerId}}&serialId={{../serialId}}&modelId={{../id}}&modelName={{../title}}&image={{../photo}}&isMain=1
点击车型跳转:pcautobuy://model/?modelId={{id}}&modelName={{title}}&areaId={{areaId}}
优惠详情页:pcautobuy://get-promotionDetail/{{newsId}}?areaId={{../areaId}}&modelId={{../id}} newsId指优惠活动id
购车优惠:pcaction://click-discount
1.6车型综述
后端接口
http://price.pcauto.com.cn/interface/iphone/atom/price/model_overview.jsp?mid=34626 车型基本信息 http://price.pcauto.com.cn/interface/iphone/atom/price/model_params.jsp?mid=34626 参数信息 http://price.pcauto.com.cn/interface/iphone/atom/price/model_calculator_basic_json.jsp?mIds=34626 基础数据如排量等 http://price.pcauto.com.cn/interface/iphone/dealer_page_list_json.jsp?modelId="+modelId+"&rId="+areaId+"&pageNo=1&pageSize=1000 经销商信息 http://price.pcauto.com.cn/interface/iphone/get_lower_modelPrice.jsp?mid=" + modelId + "&rid=" + areaId 车型本地最低价 http://mall.pcauto.com.cn/autoMall/interface/auto_mall_gct_list_by_sg_json.jsp?regionId=1&serialId=4313车系下是否有团购信息
HTTP请求方式:get
是否需要登录:false
返回格式:html
缓存方式:
缓存时间:60
说明:
请求参数:
| 参数名 | 类型 | 必须 | 说明 |
| areaId | int | N | 地区ID |
| modelId | int | N | 车型ID |
| v | string | N | 版本号 |
| isCompared | int | N | 是否已比较 |
| isSubscribed | int | N | 是否已订阅 |
*部分返回数据*
{
"bbsId": "16300",
"brand": "雪佛兰",
"brandId": "225",
"gfPrice": "8.99万",
"kind": "紧凑型车",
"manufacturer": "上汽通用雪佛兰",
"minPrice": "7.69万起",
"modelName": "科鲁兹 2015款 1.5L 经典 SL MT ",
"price": "8.99",
"productYear": "2014-09",
"serialGorup": "科鲁兹",
"serialGorupId": 3544,
"serialGroup": "科鲁兹",
"serialId": "3544",
"shortName": "1.5L 经典 SL MT",
"state": "在售",
"url_120x90": "http://img.pcauto.com.cn/images/upload/upc/tx/auto5/1412/24/c0/1054735_1054735_1419403643424_120x90.jpg",
"url_400x300": "http://img.pcauto.com.cn/images/upload/upc/tx/auto5/1412/24/c0/1054735_1054735_1419403643424_400x300.jpg",
"baseParameter": [
"厂商",
"上汽通用雪佛兰",
"级别",
"紧凑型车",
"上市时间",
"2014-09",
"发动机",
"1.5L L4",
"进气形式",
"自然吸气",
"最大马力(PS)",
"113",
"最大扭矩(N·m)",
"141",
"变速箱",
"5挡手动",
"车身结构",
"4门5座三厢车",
"长×宽×高(mm)",
"4643×1797×1477",
"轴距(mm)",
"2685",
"最高车速(km/h)",
"178",
"官方0-100km/h加速(s)",
"13.2",
"实测0-100km/h加速(s)",
"-",
"实测100-0km/h制动(m)",
"-",
"工信部综合油耗(L/100km)",
"6.6",
"整车质保",
"三年或10万公里"
],
"detail": [
{
"groupName": "车身",
"groupDetail": [
"车身结构",
"三厢车",
"长度(mm)",
"4643",
"宽度(mm)",
"1797",
"高度(mm)",
"1477",
"轴距(mm)",
"2685",
"前轮距(mm)",
"1544",
"后轮距(mm)",
"1565",
"最小离地间隙(mm)",
"-",
"车重(kg)",
"1320",
"车门数(个)",
"4",
"座位数(个)",
"5",
"油箱容积(L)",
"54",
"行李厢容积(L)",
"461",
"行李厢最大容积(L)",
"-",
"货箱尺寸(mm)",
"-",
"最大载重质量(kg)",
"-"
]
},],
"logo": "http://img.pcauto.com.cn/images/upload/upc/tx/auto5/1412/24/c0/1054735_1054735_1419403643424_400x300.jpg",
"logo2": "http://img.pcauto.com.cn/images/upload/upc/tx/auto5/1412/24/c0/1054735_1054735_1419403643424_120x90.jpg",
"photoTotal": "186",
"dealers": [默认排序:
{
"phone": "400-611-6910,283",
"poc400Phone": "4006116910-283",
"areaId": "26",
"city": "广东 广州",
"mapY": "22.987959",
"id": 42300,
"mapX": "113.362339",
"vip": 2,
"modelType": "1",
"isMarketPrice": 1,
"lowerPrice": "0.0",
"dealerMapId": 67342,
"dealerNewsId": 11280906,
"isShow24Icon": 1,
"dealerName": "广州迅锐汽车销售服务有限公司",
"discountPrice": "7.79",
"aq": "4S店",
"dealerShortName": "广州迅锐",
"price": "8.99",
"priceRange": "暂无报价",
"areaName": "番禺区",
"address": "广州市番禺区迎宾大道冼立交南300米(瑞华汽车城)",
"nameListRange": 0,
"is400Phone": 1,
"disPriceRange": "",
"highPrice": "0.0",
"qbPrice": 7.97,
"modelDiscount": "1.20",
"minPrice": "7.79",
"shouFu": 2.34,
"total": 9.09,
"monthPay": 0.15
},
],
"dealers2": [价格最低排序(同默认排序)],
"nativeMinPrice": "7.69万起",
"param": {
"modelId": "34616",
"v": "1.1.0",
"areaId": "1",
"isCompared": "0",
"isSubscribed": "1",
"fmt": "json",
"activityId": 0,
"paiLiang": 1485,
"jrjBzzw": "5",
"introduce": 0,
"serialId": "3544",
"pageName": "models"
}
}
协议说明:
车型图片:pcautobuy://model-photo/?modelId={{param.modelId}}&photoTotal={{photoTotal}}
已收藏:pcautobuy://deleteSubscribed/?modelId={{param.modelId}}&modelName={{modelName}}
收藏:pcautobuy://addSubscribed/?modelId={{param.modelId}}&modelName={{modelName}}
求组团:pcautobuy://serial-activity-initiate/?modelId={{param.modelId}}&modelName={{modelName}}
去团购:pcautobuy://model-activity-detail/?activityId={{param.activityId}}&modelId={{param.modelId}}&areaId={{param.areaId}}
询底价:pcautobuy://auto-ask-price/?areaId={{param.areaId}}&dealerId=0&serialId={{serialGorupId}}&modelId={{param.modelId}}&modelName={{modelName}}&image={{url_120x90}}&isMain=0
优惠详情:pcautobuy://get-promotionDetail/{{dealerNewsId}}?areaId={{../../param.areaId}}&modelId={{../../param.modelId}}
报价详情:pcaction://carprice_detial/?modelId=1&dealerId=1&serialId=1
购车计算器:pcautobuy://auto-calculator/{{../param.modelId}}?modelName={{../modelName}}&price={{minPrice}}&paiLiang={{../param.paiLiang}}&rjBzzw={{../param.jrjBzzw}}&introduce={{../param.introduce}}
1.7 经销商优惠详情
mrobot请求url:http://mrobot.pcauto.com.cn/xsp/s/auto/buy/v1.4/promotionDetail.xsp?marketId=11149672&modelId=39571
现应用接口:
http://price.pcauto.com.cn/interface/iphone/atom/dealer/dealer_market_info_json.jsp?marketId={marketId}+&modelId={modelId}//优惠基础数据
http://price.pcauto.com.cn/interface/iphone/atom/dealer/dealer_market_model_json.jsp?marketId={marketId}//得到该优惠相关的车型车系
HTTP请求方式:get
是否需要登录:false
返回格式:html
缓存方式:
缓存时间:60
说明:
请求参数:
| 参数名 | 类型 | 必须 | 说明 |
| modelId | int | N | 车型ID |
| marketId | int | Y | 优惠ID |
1.8 经销商报价详情
(mrobot开发已完成,请连开发机进行测试)
mrobot请求url:
http://mrobot.pcauto.com.cn/xsp/s/auto/buy/v1.4/offerDetail.xsp?modelId=30499&dealerId=18545&serialId=4313&areaId=1 该店有其他优惠 http://mrobot.pcauto.com.cn/xsp/s/auto/buy/v1.4/offerDetail.xsp?modelId=39571&dealerId=15075&serialId=4313&areaId=1 该店无其他优惠
现应用接口:
http://price.pcauto.com.cn/dealer/interface/app/dealer_info_json.jsp?dealerId=18454&type=1 经销商基本信息 http://price.pcauto.com.cn/interface/iphone/dealer_news_message.jsp?dealerId=18454 经销商优惠车系列表 http://price.pcauto.com.cn/interface/iphone/atom/dealer/get_dealer_model_basic_json.jsp?dealerId=18454&modelId=30499 经销商关于该车型的报价信息 http://price.pcauto.com.cn/interface/iphone/atom/pic/list_main_photo_json.jsp?modelId=30499 该车型的5张图 http://price.pcauto.com.cn/interface/iphone/atom/price/model_calculator_basic_json.jsp?mIds=30499 拿排量等数据,用于购车计算 http://price.pcauto.com.cn/interface/iphone/atom/dealer/dealer_market_model_json.jsp?marketId=87572237 该店该车系下有优惠的车型数据
HTTP请求方式:get
是否需要登录:false
返回格式:html
缓存方式:
缓存时间:60
说明:
请求参数:
| 参数名 | 类型 | 必须 | 说明 |
| modelId | int | Y | 车型ID |
| dealerId | int | Y | 经销商ID |
| serialId | int | Y | 车系ID |
| areaId | int | Y | 区域ID |
返回结构如下:
{
"vip": 2,
"phone": "400-860-0406",
"is400": 1,
"address": "总店地址:广州白云区石井凰岗(导航:“石丰路”或白云区的“广东中奥”)/天河区分店地址:广州市天河区中山大道中1240号(东圃客运站往黄埔方向1公里斜对面处);",
"shareUrl": "http://price.pcauto.com.cn/18545/",
"aq": 1,
"serialId": "4313",
"jingdu": "113.23",
"weidu": "23.20",
"dealerFullName": "广东中奥汽车销售服务有限公司",
"dealerName": "广东中奥奥迪",
"dealerId": 18545,
"modelName": "奥迪A6L 2014款 TFSI 手动基本型 ",
"dealerPrice": "31.79",
"price": "38.3",
"modelId": 30499,
"shouFu": 9.54,
"total": 35.82,
"monthPay": 0.68,
"paiLiang": 1984,
"jrjBzzw": "5",
"introduce": 0,
"minPrice": "31.79",
"discount": 0,
"result": {
"currentPrice": "31.79"
},
"images": [
"http://img.pcauto.com.cn/images/upload/upc/tx/auto5/1507/27/c28/10296862_10296862_1437983119930.jpg",
"http://img.pcauto.com.cn/images/upload/upc/tx/auto5/1507/27/c28/10296862_10296862_1437983124188.jpg",
"http://img.pcauto.com.cn/images/upload/upc/tx/auto5/1507/27/c28/10296862_10296862_1437983127737.jpg",
"http://img.pcauto.com.cn/images/upload/upc/tx/auto5/1507/27/c28/10296862_10296862_1437983127931.jpg",
"http://img.pcauto.com.cn/images/upload/upc/tx/auto5/1507/27/c28/10296862_10296862_1437983136184.jpg"
],
"models": [
{
"modelId": 30499,
"price": "38.3万",
"modelName": "奥迪A6L 2014款 TFSI 手动基本型 ",
"decline": "13.05",
"quantity": "充足",
"isReplace": 0,
"nowPrice": "33.3万",
"carField": false,
"discount": "5.00",
"shouFu": 9.99,
"total": 37.5,
"monthPay": 0.71,
"is400": 1,
"phone": "400-860-0406",
"dealerName": "广东中奥奥迪",
"minPrice": "33.3",
"paiLiang": 1984,
"jrjBzzw": "5",
"introduce": 0,
"result": {
"currentPrice": "33.3",
"disString": "购车直降5万元"
}
}
],
"param": {
"modelId": "30499",
"dealerId": "18545",
"serialId": "4313",
"areaId": "1",
"fmt": "json"
}
}
![(please configure the [header_logo] section in trac.ini)](http://www1.pconline.com.cn/hr/2009/global/images/logo.gif)