wiki:interface/pcauto_BuyAuto_1.4.0

=报价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类别int73:紧凑车型,1:SUV,72:中型车,110:小型车,76:微型车,71:中大型车,74:MPV
pageNo第几页int1
pageSize显示条数int20
areaId区域int1

返回

{
    "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://mrobot.pcauto.com.cn/xsp/s/auto/buy/v1.4/serial.xsp?serialId=4313&areaId=1&isSubscribed=0&modelIds=&inreview=1[[BR]]

后端接口

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
说明:
请求参数:

参数名类型必须说明
areaIdintY地区ID
serialIdintY车系id
isSubscribedintN是否订阅
modelIdsintN车型ID
inreviewintY是否审核

页面内数据说明:在返回的页面里添加了注释数据/*@_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://mrobot.pcauto.com.cn/xsp/s/auto/buy/v1.4/model.xsp?modelId=3462&v=1.1.0&areaId=2&isCompared=0&isSubscribed=0

后端接口

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
说明:
请求参数:

参数名类型必须说明
areaIdintN地区ID
modelIdintN车型ID
vstringN版本号
isComparedintN是否已比较
isSubscribedintN是否已订阅


*部分返回数据*

{
    "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
说明:
请求参数:

参数名类型必须说明
modelIdintN车型ID
marketIdintY优惠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
说明:
请求参数:

参数名类型必须说明
modelIdintY车型ID
dealerIdintY经销商ID
serialIdintY车系ID
areaIdintY区域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"
    }
}