interface/pcauto_BuyAuto_1.4.0 – iphone

wiki:interface/pcauto_BuyAuto_1.4.0

Context Navigation

Version 22 (modified by caozhaoyuan, 10 years ago) (diff)
--

1.6车型综述
1. 1.7 经销商优惠详情
2. 1.8 经销商报价详情

=报价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地址：

说明

返回首页焦点图/热门品牌数据

缓存时间

0

提交方式

GET

是否登录

否

数据来源

CMS

请求参数

参数名	参数含义	参数名	参数含义
rid	区域id

{
    "state": 0,
    "message": "成功",
    "banner": [
        {
            "title": "广州专享，买车就送大礼，厚惠无期",
            "areaId": "1",
            "link": "http://app.pcauto.com.cn/bjkclient/",
            "picUrl": "http://img0.pcautost3.png",
            "type": "1"
        }
    ],
    "brand": [
        1,
        20
    ]
}

返回参数说明

参数名	参数含义	参数名	参数含义
status	接口返回状态码：0成功，非0异常	message	接口返回描述信息
id	指定详情页id	type	跳转类型：1专题、2优惠tab列表、3优惠指定详情、4团购列表、5团购指定详情
areaId	地区ID	link	链接地址
picUrl	图片地址	title	标题

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 (获取销量排行榜) 说明

缓存时间

0

提交方式

GET

是否登录

登录与未登录都可请求

数据来源

论坛

参数具体传参由后端制定，车系级别对应id由后端给到，拿到的数据由mrobot过滤。另最低价字段需要再单独请求处理

参数名	参数含义	类型	是否必须	默认值
type	类别	int	是	73:紧凑车型,1:SUV,72:中型车,110:小型车,76:微型车
pageNo	第几页	int	是	1
pageSize	显示条数	int	是	20
year	年	int	否	无（year必须与month同步）
month	月	int	否	无（eg:09,12,01)

{
    "title": "SUV",
    "serials": [
        {
            "total": 10229, //销售数量 
            "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": "-",//最低价格，无最低价格时用-表示
            "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": [
        {
            "sid": "3195",
            "keyword": "天籁",
            "photo": "http://img.pcauto.com.cn/images/upload/upc/tx/auto5/1505/28/c20/7570720_7570720_1432795429921.JPG",
            "kind_name": "中型车",
            "price": "17.78-29.98万"
        },
   ]
}

返回参数说明

参数名	参数含义	类型	是否必须	默认值
sid	车系id	int	是	无
keyword	车系名称	string	是	无
photo	车系图片url	string	是	无
kind_name	车系类型	string	是	无
price	车系价格	string	是	无

1.4 团购详情页

mrobot地址： http://mrobot.pcauto.com.cn/buy/price/activityDetailv11/%s[[BR]]

说明

团购详情页接口

mrobot确认后端接口是否有返回团购状态标志位，如果没有，通知后端

缓存时间

0

提交方式

GET

是否登录

否

数据来源

mrobot后台

参数团购详情id，拼接在url后面

返回： HTML

1.5 车系综述页接口

(mrobot开发已完成，请连开发机进行测试)

http://mrobot.pcauto.com.cn/xsp/s/auto/buy/v1.3/serial.xsp?v=1.1.0&areaId=3&isSubscribed=0&serialId=4313&modelIds=

后端接口

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	是否订阅
modelId	int	N	车型ID

页面内数据说明：在返回的页面里添加了注释数据/*@_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.3/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
说明:
请求参数:

参数名	类型	必须	说明
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"
    }
}

1.7 经销商优惠详情

mrobot请求url:http://mrobot.pcauto.com.cn/xsp/s/auto/buy/v1.2/promotionDetail.xsp?marketId=7033340&modelId=33314
现应用接口：

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后续再制定方案

Download in other formats:

Plain Text

Context Navigation

Table of Contents

1.首页焦点图/品牌数据接口

1.2销量排行榜

1.3 搜索

1.4 团购详情页

1.5 车系综述页接口

1.6车型综述

1.7 经销商优惠详情

1.8 经销商报价详情

Download in other formats: