[[TOC]] =报价1.5.0接口文档 = >mrobot代理环境说明： 192.168.10.198 端口为 1080 连的是QA测试环境(192.168.74.80)[[BR]] 192.168.10.199 端口为 1080 连的是dev40的开发环境（192.168.75.40）[[BR]] '''ps:对于mrobot.pcauto.com.cn/x/前缀的接口，mrobot仅作代理，没有任何逻辑处理。''' [[BR]] ---------- === 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 [[BR]] ** 购车贷款跳转协议 ** >协议url：pcautobuy://serial-jr-products/?serialId=123&areaId=1 [[BR]] >跳转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 [[BR]] >协议url：pcautobuy://serial-jr-products/?serialId=123&modelId=321&areaId=1 [[BR]] >跳转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 [[BR]] > 车型经销商：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位）|| **返回** {{{#!java { "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¤tPrice=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 **说明** {{{#!java 此处只作样式修改新增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(有则传无则不传)|| {{{#!java 重点在这里==================================================================》这里面涉及几个页面入口的跳转协议需要改，加多一个newsId的参数表示优惠详情ID,具体如下： pcautobuy://auto-get-promotion/?dealerId={{../dealerId}}&serialId={{../serialGroupId}}&modelId={{modelId}}&modelName={{modelName}}&image={{../image}}¤tPrice={{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需求去掉更多中的小三角对应的购车计算按钮 [[BR]] > 返回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 [[BR]] {{{#!java 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需求去掉更多中的小三角对应的购车计算按钮 [[BR]] > 返回HTML [[BR]]现应用接口： {{{#!java 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 该店该车系下有优惠的车型数据 }}} [[BR]]HTTP请求方式:get [[BR]]是否需要登录:false [[BR]]返回格式:html [[BR]]缓存方式: [[BR]]缓存时间:60 [[BR]]说明: [[BR]]请求参数:[[BR]] ||参数名||类型||必须||说明|| ||modelId||int||Y||车型ID|| ||dealerId||int||Y||经销商ID|| ||serialId||int||Y||车系ID|| ||areaId||int||Y||区域ID|| 返回结构如下： {{{#!java { "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地址：http://mrobot.pcauto.com.cn/xsp/s/auto/buy/v1.7/getAutoBuyOrder.xsp?m=getOrderList&dId=8de02a33d33a3a50988bb45c39281e2e&pageNo=1&pageSize=20 **说明** 1.7需求中再增加一个接口，补全缺失字段[[BR]] > 返回HTML **请求参数**= ||参数名||类型||必须||=说明=|| ||pageNo||int||N||第几页|| ||pageSize||int||N||显示页数|| ||m||String||N||方法名|| ||dId||String||Y||设置ID|| ---------- {{{#!java [ { "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"//申请人 } ] }}} === 2.6 在售车系 === >http://mrobot.pcauto.com.cn/xsp/s/auto/buy/v1.5/getDealerSalesModels.xsp?dealerId=18545&serialId=5 [[BR]] {{{#!java 此处Mrobot没有做更改，后端接口增加一个行情ID字段需要注意的时，此处出现本地最低价最取官方价，经销商报价，优惠行情出价三个当中最低的情况，关于跳转，如果经商价报价和优惠行情一致，数据显示将一致，如果经销商报价低于优惠行情价，优惠行情与外的经销商价格是显示不致的。针对车系发布一个行情对应一个商家，此时有优惠的车型对应的优惠ID是一致的。 }}} **应用后端**[[BR]] >http://dev3.pcauto.com.cn:8001/dealer/interface/app/dealer_model_json.jsp?dealerId=18545&serialId=5 (获取经销商在售车系) [[BR]] **请求参数** ||= 车系id =||= 经销商id =|| **字段规则**[[BR]] 1.有discountPrice 则显示discountPrice ，否则请使用price字段 [[BR]] 2.discount不为0，则显示绿色降价discount **返回** {{{#!java { "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": "夏朗"，注意点击预约试驾时，要把车系名+车型名拼接后传给预约试驾接口 } }}}