wiki:interface/pcauto_BuyAuto_1.7.0

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

--

=报价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车系综述页

(mrobot开发完成,请连接开发机进行测试)

mrobot地址: http://mrobot.pcauto.com.cn/xsp/s/auto/buy/v1.7/serial.xsp?v=1.1.0&serialId=4457&areaId=1&isSubscribed=0&modelIds=&inreview=0

购车贷款跳转协议

协议url:pcautobuy://serial-jr-products/?serialId=123&areaId=1
跳转url: http://m.jr.pcauto.com.cn/choose/r1/sg123/f3/ 如果serialId=123 那么填sg123,如果areaId=1 那么填r1

说明

返回HTML


1.2车型综述页

(mrobot开发完成,请连接开发机进行测试)

mrobot地址: http://mrobot.pcauto.com.cn/xsp/s/auto/buy/v1.7/model.xsp?v=1.1.0&modelId=42028&areaId=1&isCompared=0&isSubscribed=0
协议url:pcautobuy://serial-jr-products/?serialId=123&modelId=321&areaId=1
跳转url: http://m.jr.pcauto.com.cn/choose/r1/sg123-m321/f3/ 如果serialId=123 那么填sg123,如果modelId=321 那么填m321,如果areaId=1 那么填r1

说明

返回HTML


1.3车系/车型页经销商tab接口

(mrobot开发完成,请连接开发机进行测试)

mrobot地址: http://mrobot.pcauto.com.cn/xsp/s/auto/buy/v1.7/tabDealers.xsp?&serialId=4457&modelId=1&areaId=1&lng=113.421435&lat=23.181655

说明

返回车型/车系页经销商tab数据

数据来源

车系经销商: http://price.pcauto.com.cn/interface/iphone/dealer_page_list_json.jsp?vs=1.4&serialGroupId=4457&rId=1&pageNo=1&pageSize=25
车型经销商: http://price.pcauto.com.cn/interface/iphone/dealer_page_list_json.jsp?vs=1.4&modelId=42028&rId=1&pageNo=1&pageSize=25

请求参数

参数名类型必须说明
areaId int城市ID
serialIdint车系ID
modelIdint车型ID
latfloat纬度(小数点后6位)
lngfloat经度(小数点后6位)

返回

{
    "total": 11,
    "dealers": [
        {
            "id": 70535,
            "name": "广东锦泰汽车销售服务有限公司",
            "level": "4S店",
            "dis": "7.7km",
            "address": "广州市黄埔区科学城光谱东路79号"
        }

2.1我要优惠页

(mrobot开发完成,请连接开发机进行测试)

mrobot地址: http://mrobot.pcauto.com.cn/xsp/s/auto/buy/v1.4/getPromotion.xsp?v=1.1.0&areaId=1&isMain=1&v4activity=1.5&currentPrice=33.36&modelId=42028&disString=%E8%B4%AD%E8%BD%A6%E7%9B%B4%E9%99%8D4.98%E4%B8%87%E5%85%83&image=http://img.pcauto.com.cn/images/upload/upc/tx/auto5/1502/24/c4/3229137_3229137_1424770255400_120x90.jpg&modelName=%E5%A5%A5%E8%BF%AAQ5%202016%E6%AC%BE%2040%20TFSI%20%E8%BF%9B%E5%8F%96%E5%9E%8B&serialId=4457&dealerId=70535&name=&tel=&appKey=4f4277c7a1428d2000000483&chId=app_store&devId=d6c0e0c274a89c4f66c2eb747ea1850e2e0fb016&countDevId=020000000000&referer=discount_detail_top&newsId=122333333

说明

  此处只作样式修改新增newsId参数用于表示优惠详情ID,作用:找对应的结束时间,然后页面显示。

返回HTML

请求参数=

参数名类型必须说明
参数名类型必须说明
modelIdintY车型ID
modelNameintY车型名称
areaIdintY地区id
serialIdintY车系id
dealerIdintN经销商id
nameStringN提交名称
telStringN提交电话号码
appKeyStringN魔方appKey
chIdStringN设备类型
devIdintN设备ID
refererStringN备注
vStringN版本号
newsIdintN优惠详情ID(有则传无则不传)
    重点在这里==================================================================》
   这里面涉及几个页面入口的跳转协议需要改,加多一个newsId的参数表示优惠详情ID,具体如下:
pcautobuy://auto-get-promotion/?dealerId={{../dealerId}}&serialId={{../serialGroupId}}&modelId={{modelId}}&modelName={{modelName}}&image={{../image}}&currentPrice={{nowPrice}}&disString={{discountStr}}&newsId={{newsId}}

此处列出下面需要修改的列表
mrobot:
我要优惠协议修改:
车系综述页
http://mrobot.pcauto.com.cn/xsp/s/auto/buy/v1.5/serial.xsp?devId=bee56a5dc4583400b6842e79009d0c72&appKey=4cf6896ea14e476c000005f6&serialId=3524&areaId=1&isSubscribed=0&modelIds=&v=1.1.0

优惠详情页
http://mrobot.pcauto.com.cn/xsp/s/auto/buy/v1.4/promotionDetail.xsp?devId=bee56a5dc4583400b6842e79009d0c72&appKey=4cf6896ea14e476c000005f6&marketId=12264889&modelId=33313&areaId=1

报价详情页
http://mrobot.pcauto.com.cn/xsp/s/auto/buy/v1.4/offerDetail.xsp?devId=bee56a5dc4583400b6842e79009d0c72&appKey=4cf6896ea14e476c000005f6&dealerId=15075&modelId=41610&serialId=3524&areaId=1

促销详情页
http://mrobot.pcauto.com.cn/xsp/s/auto/buy/v1.5/getPromotionDetailv.xsp?marketId=12326514

'''app需要修改的页面包括:
优惠列表页和在售车系页'''


2.2 团购详情页

(mrobot开发完成,请连接开发机进行测试)

mrobot地址: http://mrobot.pcauto.com.cn/buy/price/activityDetailv11/8995?areaId=1&modelId=0&serialId=0&name=&tel=&&appKey=4f4277c7a1428d2000000483&chId=app_store&dId=d6c0e0c274a89c4f66c2eb747ea1850e2e0fb016&referer=lookcar_group_detail&myFlag=1(我的团购)

说明

返回HTML

请求参数=

参数名类型必须说明
modelIdintN车型ID
serialIdintN车系ID
areaIdintY地区ID
tuanIdintY团购ID(即8995)
nameintN用户名
telintN手机号码
myFlagintN表标识,1表示从我的团购跳转过来,0表示正常流程,默认为0

2.3 优惠详情页

(mrobot开发完成,请连接开发机进行测试)

mrobot地址: http://mrobot.pcauto.com.cn/xsp/s/auto/buy/v1.4/promotionDetail.xsp?marketId=12264915&areaId=1&modelId=43797&appKey=4f4277c7a1428d2000000483&chId=app_store&devId=0b5210a97641d61058d423f2d8ed7281b7c6cf02&inreview=0

说明

1.7需求去掉更多中的小三角对应的购车计算按钮

返回HTML

请求参数=

参数名类型必须说明

2.4 报价详情页

(mrobot开发完成,请连接开发机进行测试)

mrobot地址: http://mrobot.pcauto.com.cn/xsp/s/auto/buy/v1.4/promotionDetail.xsp?marketId=12264915&areaId=1&modelId=43797&appKey=4f4277c7a1428d2000000483&chId=app_store&devId=0b5210a97641d61058d423f2d8ed7281b7c6cf02&inreview=0

说明 1.7需求去掉更多中的小三角对应的购车计算按钮

返回HTML

请求参数=

参数名类型必须说明

2.5 我的团购列表页

(开发中)

mrobot地址: http://mrobot.pcauto.com.cn/xsp/s/auto/buy/v1.7/getAutoBuyOrder.xsp?m=getOrderList&dId=885520fde3c735ee9ae2d8bccd7f25b7&pageNo=1&pageSize=20

说明 1.7需求中再增加一个接口,补全缺失字段

返回HTML

请求参数=

参数名类型必须说明
pageNointN第几页
pageSizeintN显示页数
mStringN方法名
dIdStringY设置ID

{
    "data": [
        {
            "acId": 3208,
            "deadline": "2015-07-18",
            "discount": 0,
            "discountPrice": 7.98,
            "image": "http://img.pcauto.com.cn/images/upload/upc/tx/auto5/1601/28/c85/17990419_17990419_1453976590690_350x260.jpg",
            "orderCount": 104,
            "sgId": 377,
            "sgName": "阳光",
            "title": "7月18日东风日产全系夏日放价大团购"
        }
    ]
}