wiki:interface/pcauto_BuyAuto_1.5.0

Version 25 (modified by caozhaoyuan, 10 years ago) (diff)

--

Table of Contents

    1. 1.1找车页附近经销商接口
    2. 1.2经销商主页
    3. 1.3经销商简介
    4. 1.4预约试驾
    5. 1.5促销优惠列表接口

=报价1.5.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.1找车页附近经销商接口


说明

返回首附近经销商数据

缓存时间

0

提交方式

GET

是否登录

否

数据来源

请求参数=

城市id 品牌id 经度 维度

返回 

{
     "status": 0,
"message": "操作成功",
    "datas": [
        {
           经销商id          int
         经销商名称         String 
         经销商简称         String
        经销商类型          int 
         距离               float/double
         车身图片           String
         主营品牌                   
        },
    ],
}

1.2经销商主页

MROBOT接口
url:  http://mrobot.pcauto.com.cn/xsp/s/auto/buy/v1.5/dealersDetailv.xsp?dealerId=18545

后端接口
url:  http://price.pcauto.com.cn/dealer/interface/app/dealer_info_json.jsp?dealerId=18545&type=1 获取经销商信息
url:  http://price.pcauto.com.cn/dealer/interface/app/dealer_serialgroup_json.jsp?dealerId=18545&pageSize=50&pageNo=1 获取经销商在售车系
url:  http://price.pcauto.com.cn/interface/iphone/dealer_news_message.jsp?dealerId=18545&pageSize=50&pageNo=1 获取经销商促销优惠
请求参数

参数名类型必须说明
dealerIdint是无


返回格式 

{
    "id": 18545,
    "vip": 2,
    "phone": "400-611-6910,247",
    "is400": 1,
    "address": "总店地址：广州白云区石井凰岗（导航：“石丰路”或白云区的“广东中奥”）/天河区分店地址：广州市天河区中山大道中1240号（东圃客运站往黄埔方向1公里斜对面处）；",
    "name": "广东中奥汽车销售服务有限公司",
    "shareUrl": "http://price.pcauto.com.cn/18545/",
    "lng": "113.23",
    "aq": 1,
    "shortName": "广东中奥奥迪",
    "lat": "23.20",
    "hasPro": 1,
    "onsaleSg": {
        "total": 20,
        "pageCount": 1,
        "pageNo": 1,
        "pageSize": 50,
        "data": [
            {
                "mfName": "奥迪(进口)",
                "createTime": "2016-01-02",
                "price": "52.8-65.8 万",
                "serialId": 3605,
                "promotion": "1",
                "kindName": "中型SUV",
                "image": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1307/15/c0/23339337_1373853011765_180x135.jpg",
                "serialName": "奥迪Q5(进口)",
                "_rs_": "SerialGroupInfo"
            },
        ]
    },
    "mfNames": "奥迪(进口)  一汽奥迪",
    "aqName": "[4S店]"
}


相关协议 

  经销商简介：暂无(需要经销商id)
  400电话   ：pcaction://webview_tel/{{phone}}?name={{dealerName}}
  查看地图  ：pcautobuy://dealer-map/?jing={{lng}}&wei={{lat}}&dealerName={{dealerName}}&dealerAddress={{address}}
  预约试驾  ：暂无(同询底价)
  促销优惠  ：暂无((需要经销商id、pageSize、pageNo)
  // 询底价    ：pcautobuy://auto-ask-price/?dealerId={{dealerId}} 暂时屏蔽
  在售车系  ：暂无(级别、经销商id、车系id)

1.3经销商简介

MROBOT接口
url:  http://mrobot.pcauto.com.cn/xsp/s/auto/buy/v1.5/getDealerDetail.xsp?dealerId=18545&type=2
请求参数

参数名类型必须说明
dealerIdint是无
typeint否默认为2(有荣誉信息时显示)


返回格式 

{
    "dealerDesc": "非凡地位，坐拥羊城\r<br>广东中奥汽车销售服务有限公司是奥迪中国特许经销商中的执牛耳者，成立于1999年。北有石井总店、东有东圃分店、每店具有推行整车销售、维修服务、备件供应、信息反馈四位一体的奥迪国际品牌专营模式。\r<br>光芒凝汇，开启尊程\r<br>中奥，奥迪中国销售史上众多第一的创造者：中国首批特许经销商；广东地区第一家奥迪4S标准展厅；第一家引入试车道概念；华南区第一家高档车友俱乐部；一汽大众华南唯一备件中转库；奥迪华南地区首家“品荐二手车”中心......\r<br>人本服务，双赢天下\r<br>秉承奥迪汽车一贯品质，优雅进取、豪华严谨，为超越时代的技术发展提供全方位服务，中奥全情全力，让尊贵更加贴心出众，更让每一款奥迪经典快意驰骋，后顾无忧。",
    "phone": "400-611-6910转247",
    "is400": 1,
    "lng": "113.23204663429462",
    "aq": 1,
    "id": 18545,
    "vip": 2,
    "address": "总店地址：广州白云区石井凰岗（导航：“石丰路”或白云区的“广东中奥”）/天河区分店地址：广州市天河区中山大道中1240号（东圃客运站往黄埔方向1公里斜对面处）；",
    "name": "广东中奥汽车销售服务有限公司",
    "shareUrl": "http://price.pcauto.com.cn/18545/",
    "shortName": "广东中奥奥迪",
    "lat": "23.203753780834113",
    "certificates": [
        {
            "name": "",
            "url": "http:&#x2F;&#x2F;img.pcauto.com.cn&#x2F;images&#x2F;upload&#x2F;upc&#x2F;tx&#x2F;auto5&#x2F;1501&#x2F;19&#x2F;c0&#x2F;2031248_1421630315278_200x150.jpg"
        },
        {
            "name": "",
            "url": "http:&#x2F;&#x2F;img.pcauto.com.cn&#x2F;images&#x2F;upload&#x2F;upc&#x2F;tx&#x2F;auto5&#x2F;1501&#x2F;19&#x2F;c0&#x2F;2031251_1421630333431_200x150.jpg"
        },
        {
            "name": "",
            "url": "http:&#x2F;&#x2F;img.pcauto.com.cn&#x2F;images&#x2F;upload&#x2F;upc&#x2F;tx&#x2F;auto5&#x2F;1501&#x2F;19&#x2F;c0&#x2F;2031434_1421630544388_200x150.jpg"
        }
    ]
}


后端接口
url:  http://price.pcauto.com.cn/dealer/interface/app/dealer_info_json.jsp?dealerId=18545&type=2 获取经销商信息+荣誉等

1.4预约试驾

MROBOT接口(已完成)
url:  http://mrobot.pcauto.com.cn/buy/price/testdriverv?serialId=3524&dealerId=69115&dealerName=hehe&areaId=1&areaName=hehe&appKey=&chId=app_store&devId=
请求参数

参数名类型必须说明
serialIdint是车系ID
dealerIdint是经销商ID
dealerNamestring是经销商名称
areaIdint是地区ID
areaNamestring是地区名称


1.5促销优惠列表接口

MROBOT接口(已完成) url： http://mrobot.pcauto.com.cn/buy/price/dealerPromotionList/17435?pageSize=20&pageNo=1

请求参数

参数名类型必须说明
/17435int是经销商ID
pageSizeint是地区ID
pageNostring是地区名称


返回 

{
    "datas": [
        {
            "content": "广州猴年大促销 丰田凯美瑞降2.8万元",
            "date": "2016-01-04",
            "id": "11713156",
            "serialGroupId": "4550",
            "url": "http://m.pcauto.com.cn/auto/market/17435-11713156.html"
        }
    ],
    "pageCount": 1,
    "pageNo": 1,
    "pageSize": 20,
    "total": 10
}}}}


=== 1.6促销详情 ===
**MROBOT接口**[[BR]]
url: http://mrobot.pcauto.com.cn/xsp/s/auto/buy/v1.5/getPromotionDetailv.xsp?marketId=11193694
[[BR]][[BR]]
**后端接口**[[BR]]
url: http://price.pcauto.com.cn/interface/iphone/atom/dealer/dealer_market_info_json.jsp?marketId=11193694   获取经销商促销信息[[BR]]
url: http://price.pcauto.com.cn/interface/iphone/atom/dealer/dealer_market_model_json.jsp?marketId=11193694  获取经销商促销车型[[BR]]
**请求参数**
||参数名||类型||必须||说明||
||marketId||long||是||无||
[[BR]]
**返回格式**
{{{#!java
{
    "dealerId": "79574",
    "phone": "400-611-6820,229",
    "isShow24Icon": 0,
    "is400": 1,
    "agentQualification": "2",
    "serialGroupId": 3524,
    "decline": "0.66",
    "dealerName": "北京俊捷嘉华汽车",
    "aq": "2",
    "content": "北京俊捷嘉华一汽奥迪店内奥迪A4L现车充足，近期购车优惠20万，同时赠送价值20000元的大礼包。感兴趣的朋友不妨在页面下方留下您的联系电话，我们会有专业的销售为您服务，或直接到店咨询。相关车型及报价如下表",
    "vip": "1",
    "giftPackage": {
        "giftPackage": "LED日间行车灯+抬头显示+脚垫 把套 香水",
        "giftPrice": "20000",
        "otherGift": ""
    },
    "discountInfo": {
        "dealerId": "79574",
        "shortInfo": "奥迪A4L优惠20万",
        "info": "年底大促销 2016款奥迪A4L最高优惠20",
        "expiry": "2015.12.01-2015.12.31"
    },
    "address": "北京市朝阳区北五立水桥58号",
    "shareUrl": "http://price.pcauto.com.cn/market/79574-11193694.html",
    "lnglat": "116.424459,40.043103",
    "serialGroupName": "奥迪A4L",
    "namelistRange": "2",
    "deadline": "12月31",
    "dealerFullName": "北京俊捷嘉华汽车销售有限公司",
    "isValid": 0,
    "type": 1,
    "models": [
        {
            "modelId": 41610,
            "price": "27.28万",
            "modelName": "奥迪A4L 2016款 30 TFSI 手动舒适型",
            "decline": "36.66",
            "quantity": "现车充足",
            "isReplace": 0,
            "nowPrice": "17.28",
            "carField": false,
            "discount": "10",
            "modelType": "1"
        },
     ],
    "image": "http://imgrt.pconline.com.cn/images/upload/upc/tx/auto5/1510/09/c3/13665776_13665776_1444353094381/spcgroup/bbs/center/500x375.jpg",
    "marketId": "11193694",
    "lng": "116.42",
    "lat": "40.04"
}
}}}
[[BR]]
**相关协议**
{{{#!java
  优惠详情：pcautobuy://get-promotionDetail/{{../marketId}}?modelId={{modelId}}
  400电话 ：pcaction://webview_tel/{{phone}}?name={{dealerName}}
  我要优惠: pcautobuy://auto-get-promotion/?dealerId={{../dealerId}}&serialId={{../serialGroupId}}&modelId={{modelId}}&modelName={{modelName}}&image={{../image}}&currentPrice={{nowPrice}}&disString='购车直降{{discount}}万元'
}}}




=== 1.7在售车系 ===

**请求参数**
||= 城市id =||= 车系id =||= 经销商id =||= 区域id =||

**返回**
{{{#!java
{
"status": 0,
"message": "操作成功",
Page
pageSize
车系名称：
官方价：
data:[
{
描述  (原型上的 2.0T )
车型id
                车型名
                价格
                官方价
                下降
                 
}，
 ]

}
}}}


=== 1.8销量排行榜 ===
** (mrobot开发已完成，请连开发机进行测试) **

>mrobot地址：http://mrobot.pcauto.com.cn/xsp/s/auto/buy/v1.4/hotSellSerials.xsp?year=2015&month=1&type=73  [[BR]]
应用后端url：http://price.pcauto.com.cn/top/sales/s2-t73.html  (获取销量排行榜)  [[BR]]
http://price.pcauto.com.cn/interface/iphone/get_lower_modelPrice.jsp?vs=1.3&rid=1&sid=车系ID 取本地最低价数据接口 [[BR]]
             
**说明**

> 

**缓存时间**

>0

**提交方式**

> GET

**是否登录**

> 登录与未登录都可请求

**数据来源**

>论坛

**参数**
||= 参数名 =||= 参数含义 =||类型||是否必须|| 默认值||
||type||类别||int||是||73:紧凑车型,1:SUV,72:中型车,110:小型车,76:微型车,71:中大型车，74：MPV||
||pageNo||第几页||int||是||1||
||pageSize||显示条数||int||是||20||
||areaId||区域||int||是||1||
||year||年份||int||否||无||
||month||月份||int||否||无||

**返回**
{{{
  year参数需与month同步存在与否。
{
    "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" //车系名称
        }
}
}}}


=== 2.1优惠全部 ===

**请求参数**=（首次请求不需要添加参数）
||= 区域id =||=品牌id=||= 车系id =||= 车型id =||
其中品牌id、车系id、车型id只选其中之一传参，代表不同的列表获取不同的数据

**返回**
{{{#!java
{
 total: 143,                    //团购总数
 pageCount: 15,         //团购总页数
 pageNo: 1,                     //第几页
 pageSize: 10,          //每页大小
 Type           //排序的规则类型
 品牌名、车系名、车型名（根据传参返回对应的名称）
 datas:[
  {
   车系id or 车型id（如果穿的是品牌id，这里是车系id，如果参数传的的车系或者车型id，这里是车型id）
   车系名称 or 车型名称（如果穿的是品牌id，这里显示车系名称，如果参数传的是车系或者车型id，这里是车型名称）
   总数(查看更多优惠的总数，如果参数传的是车型id，这里可以不要)

  “carmodel”:
   {  
       modelId: 7616,                   //车型id
       price: 7.78,                     // 车型官方价
       name: "锐欧 2007款 1.4 手动 豪华型",     //车型名称
       discountPrice: 5.78,     //促销价
       discount : 20000,                        //降幅
       giftPackage : "送10000元礼包",       //礼包优惠
       modelType : "现车充足",              //现车情况
    },
    “dealer”:
     {
        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.2车系优惠列表，根据接口制作改样式 ===

=== 2.3车型优惠列表，根据接口制作改样式 ===

=== 2.4车系-综述-优惠列表，根据接口制作改样式 ===




=== 3.1 图片列表 ===
**MROBOT接口**[[BR]]
url: http://mrobot.pcauto.com.cn/xsp/s/auto/buy/v1.3/pictures.xsp?serialGroupId=4313&modelId=0&colorId=105182&typeId=2&pageNo=1&pageSize=60  [[BR]]
**请求参数**
||参数名||类型||必须||说明||
||serialGroupId||int||否||无||
||modelId||int||否||无||
||colorId||long||否||无||
||typeId||int||否||无||
||pageNo||int||否||无||
||pageSize||int||否||无||

=== 3.2车系年份排序 ===
待产品确认规则

=== 3.3 车型综述页 经销商远近排序 ===
>mrobot地址：http://mrobot.pcauto.com.cn/xsp/s/auto/buy/v1.5/model.xsp?lng=23.140192&lat=113.324943&devId=bee56a5dc4583400b6842e79009d0c72&appKey=782ae91ba147435a00000539&modelId=41610&areaId=1&isCompared=0&isSubscribed=0&v=1.1.0 [[BR]]
**说明**

> 加多一个tab页，显示经销商由近到远排序

**缓存时间**

>0

**提交方式**

> GET

**是否登录**

> 否

**数据来源**
{{{
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车系下是否有团购信息
}}}

**请求参数**
   ||= 参数名 =||= 参数含义 =||=参数名=||=参数含义=||
   ||参数名||类型||必须||说明||
   ||areaId||int||N||地区ID||
   ||modelId||int||N||车型ID||
   ||v||string||N||版本号||
   ||isCompared||int||N||是否已比较||
   ||isSubscribed||int||N||是否已订阅||
   ||lat||float||Y||纬度||
   ||lng||float||Y||经度||
**返回**
{{{#!java
   协议说明：
     车型图片：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}}
}}}