interface/pcauto_BuyAuto_1.7.0 – iphone

wiki:interface/pcauto_BuyAuto_1.7.0

Context Navigation

=报价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?modelId=1234&areaId=1&lng=113.421435&lat=23.181655

车系页 http://mrobot.pcauto.com.cn/xsp/s/auto/buy/v1.7/tabDealers.xsp?&serialId=4457&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
serialId	int	否	车系ID
modelId	int	否	车型ID
lat	float	是	纬度（小数点后6位）
lng	float	是	经度（小数点后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

请求参数=

参数名	类型	必须	说明
参数名	类型	必须	说明
modelId	int	Y	车型ID
modelName	int	Y	车型名称
areaId	int	Y	地区id
serialId	int	Y	车系id
dealerId	int	N	经销商id
name	String	N	提交名称
tel	String	N	提交电话号码
appKey	String	N	魔方appKey
chId	String	N	设备类型
devId	int	N	设备ID
referer	String	N	备注
v	String	N	版本号
newsId	int	N	优惠详情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

请求参数=

参数名	类型	必须	说明
modelId	int	N	车型ID
serialId	int	N	车系ID
areaId	int	Y	地区ID
tuanId	int	Y	团购ID（即8995）
name	int	N	用户名
tel	int	N	手机号码
myFlag	int	N	表标识，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/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 该店无其他优惠

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

返回HTML

现应用接口：

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

参数名	类型	必须	说明
modelId	int	Y	车型ID
dealerId	int	Y	经销商ID
serialId	int	Y	车系ID
areaId	int	Y	区域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"
    }
}

2.5 我的团购列表页

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

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

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

后端接口：
  http://wxzs.pcauto.com.cn/interface/app/get_autobuyOrder.jsp?page=" + pageNo + "&m=" + m + "&dId=" + dId + "&size=" + pageSize
  http://mall.pcauto.com.cn/autoMall/interface/app/get_tuangou_order_info.jsp?tgId="+e.acId+"&devId="+dId

返回HTML

请求参数=

参数名	类型	必须	说明
pageNo	int	N	第几页
pageSize	int	N	显示页数
m	String	N	方法名
dId	String	Y	设置ID

[
    {
        "acId": 502,//团购ID
        "deadline": "2014-12-20",//结束时间
        "discount": 5.68, //折扣下降
        "discountPrice": 19.8, //现价
        "image": "http://img.pcauto.com.cn/images/upload/upc/tx/auto5/1508/25/c25/11686880_11686880_1440495693291_350x260.JPG",//logo
        "orderCount": 11,//已参加团购数
        "sgId": 4406, //车系Id
        "sgName": "欧蓝德", //车系名
        "title": "三菱岁末底价团购 赶超双11诱人惊喜", // 团购标题
        "regionId": 1, // 地区
        "modelId": 26365,//车型Id
        "phone": "13785896325", //电话号码
        "name": "lily"//申请人
        "isValid":1//2016-03-07 增加isValid字段表跳进团购详情页前验证其有效性。1表有效0表无效。
    }
]

2.6 在售车系

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

http://mrobot.pcauto.com.cn/xsp/s/auto/buy/v1.5/getDealerSalesModels.xsp?dealerId=18545&serialId=5

  此处Mrobot没有做更改，后端接口增加一个行情ID字段
  需要注意的时，此处出现本地最低价最取官方价，经销商报价，优惠行情出价三个当中最低的情况，
  关于跳转，如果经商价报价和优惠行情一致，数据显示将一致，如果经销商报价低于优惠行情价，优惠行情与外的经销商价格是显示不致的。
  针对车系发布一个行情对应一个商家，此时有优惠的车型对应的优惠ID是一致的。

应用后端

http://dev3.pcauto.com.cn:8001/dealer/interface/app/dealer_model_json.jsp?dealerId=18545&serialId=5 (获取经销商在售车系)

请求参数

车系id	经销商id

字段规则
1.有discountPrice 则显示discountPrice ，否则请使用price字段
2.discount不为0，则显示绿色降价discount

{
    "data": [
        {
            "models": [
                {
                    "discount": "0", 这个是降价信息，如果不为空或者0 就显示
                       "modelId": "26913",
                    "modelName": "夏朗 2013款 1.8TSI 舒适型 欧V",
                    "price": "27.76", 这个是经销商售价
                       "gfPrice": "27.76" 这个是官方价 如果discount为空 或者0 就不显示官方价
                       "discountPrice": "27.76", 这个不用管啦
                    "shortName":"" 不带车系的车型名，
                    "shortNameY":""带年款的车型名
                }
            ],
            "title": "1.8T"
        }
    ],
    "dealerNewsId": 12250918,//此处是新加的内容。
    "dealerId": 30829,
    "dealerName": "广州市璟众汽车销售服务有限公司",
    "image": "http://img.pconline.com.cn/imag00_1387775251796_400x300.jpg",
    "priceRange": "25.36-41.1万",
    "serialId": 628,
    "serialName": "夏朗"，注意点击预约试驾时，要把车系名+车型名拼接后传给预约试驾接口
}

Download in other formats:

Plain Text

Context Navigation

Table of Contents

1.1车系综述页

1.2车型综述页

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

2.1我要优惠页

2.2 团购详情页

2.3 优惠详情页

2.4 报价详情页

2.5 我的团购列表页

2.6 在售车系

Download in other formats: