wiki:interface/pcauto_BuyAuto_1.4.0

Version 5 (modified by wuxiaoling, 10 years ago) (diff)

--

=报价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.1首页焦点图

mrobot地址:

说明

首页banner接口

缓存时间

0

提交方式

GET

是否登录

数据来源

CMS

参数 type:1专题、2优惠tab列表、3优惠指定详情、4团购列表、5团购指定详情

返回

{
    "status": 0,
    "message": "操作成功",
    "datas": [
        {
            "title": "详情页标题",
            "id": "指定详情页id",
            "type": 类型,
            "img": "图片地址",
            "url": "指定详情页URL"
        },
    ],
"hotdatas": [
        {
            "品牌id"
            "品牌名称": 
            "品牌图片地址":             
        },
    ]
   
}

返回参数说明

参数名 参数含义 参数名参数含义
status 接口返回状态码:0成功,非0异常 message 接口返回描述信息
id 指定详情页id type 跳转类型: title 标题

1.2销量排行榜

mrobot地址:

应用后端url: http://price.pcauto.com.cn/top/sales/s2-t73.html (获取销量排行榜) 说明

缓存时间

0

提交方式

GET

是否登录

登录与未登录都可请求

数据来源

论坛

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

参数名 参数含义 类型是否必须 默认值
type类别int1
pageNo第几页int1
pageSize显示条数int20
yearint
monthint

返回

{
    "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://ks.pcauto.com.cn/searchSuggest2.shtml?q=%E7%A7%91&app=composite

说明

搜索车系接口

缓存时间

0

提交方式

GET

是否登录

数据来源

mrobot后台

参数 搜索关键字:keyword

返回 { "status": 0,

"message": "操作成功", "datas": [

{

"车系id" "车系名称": "车系图片地址":

“车系类型”

“车系价格区间”

},

]

}


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

参数名类型必须说明
areaIdintY地区ID
serialIdintY车系id
isSubscribedintN是否订阅
modelIdintN车型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
说明:
请求参数:

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

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

参数名类型必须说明
modelIdintN车型ID
marketIdintY优惠ID

1.8 经销商报价详情

Mrobot后续再制定方案