[[TOC]] == 1.基本约定 == {{{ 接口通用参数 req_enc=utf-8(必须放url后面) resp_enc=utf-8(必须放url后面) common_session_id=xxxx(以cookies中的优先) 接口URL: 接口URL 必填参数：参数名=xxx(多种情况用括号解析) 非必填参数：参数名=xxx(多种情况用括号解析) 说明文档参数：添加某特定参数可以直接看接口文档 是否需要登录：是,否 返回格式：json,ssi,xml 缓存方式：接口缓存（接口中返回的响应头里面的 Cache-Control），对象缓存（） 缓存时间：缓存时间 返回结果：结果可能情况 }}} [[BR]]代理环境说明： [[BR]]192.168.10.198 端口为 1080 连的是v36的测试环境（192.168.74.36） [[BR]]192.168.10.199 端口为 1080 连的是dev40的开发环境（192.168.75.40） == 2.接口列表 == =======================================================功能优化============================================== === 2.1 [=#point2.1 车型参配] === [[BR]]mrobot请求url:{{{http://mrobot.pcauto.com.cn/buy/price/modelDetail/{modelId}?areaId=1&fmt=json}}} [[BR]]现应用接口： {{{ http://price.pcauto.com.cn/interface/iphone/atom/price/model_overview.jsp?mid={modelId} 基础数据 http://price.pcauto.com.cn/interface/iphone/atom/price/model_params.jsp?mid=34224 参数 }}} [[BR]]原接口： {{{ http://price.pcauto.com.cn/interface/iphone/model_detail.jsp?mid=34224 }}} [[BR]]HTTP请求方式:get [[BR]]是否需要登录:false [[BR]]返回格式:html [[BR]]缓存方式: [[BR]]缓存时间:60 [[BR]]说明: [[BR]]请求参数:[[BR]] ||参数名||类型||必须||说明|| ||modelId||String||Y||车型ID|| ||areaId||String||Y||地区id|| [[BR]]返回结果: [[BR]]{ "baseParameter": [ "厂商", "一汽奥迪", "级别", "中大型车", "上市时间", "2014-01", "发动机"...], "gfPrice": "38.3万", "groupNameArray": [ "询价订单", "价格", "基本参数", "车身", "发动机", "电动机", "变速箱", "底盘转向", ... ], "kind": "中大型车", "manufacturer": "一汽奥迪", "minPrice": "5.75万", "modelName": "奥迪A6L 2014款 2.0 TFSI 手动基本型", "price": "38.3", "serialGorup": "奥迪A6L", "serialGorupId": 4313, "shortName": "2.0 TFSI 手动基本型", "state": "在售", "total": "0", "url": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1208/21/c7/13077074_13077074_1345530200671_80x60.jpg", "url_120x90": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1208/21/c7/13077074_13077074_1345530200671_120x90.jpg", "url_400x300": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1208/21/c7/13077074_13077074_1345530200671_400x300.jpg", "groupNameArray":[ "询价订单", "价格", "基本参数", "车身", "发动机", "电动机"...], "gfprice":"38.3万", "brand":"奥迪", "detail":[ { "groupDetail": [ "全国4S店", "0笔" ], "groupName": "询价订单" }......] } === 2.2 [=#point2.2 我要优惠] === [[BR]]mrobot请求url:{{{http://mrobot.pcauto.com.cn/xsp/s/auto/buy/v1.2/getPromotion.xsp?v=1.1.0&modelId=20062&modelName=奥迪&serialId=4313&areaId=1&dealerId=65469&name=tt&tel=13588888888&appKey=34ca62060a1474350000052f&chId=app_store&devId=cb2039424107a8f6d3847fd390d81e60ba7ab516&referer=sg_discount}}} [[BR]]现应用接口： {{{ http://price.pcauto.com.cn/dealer/interface/order/recommend_dealer.jsp?rid=" + areaId + "&sgid=" + serialId + "&type=0 http://mrobot.pcauto.com.cn/v3/price/provinceCityList城市数据 }}} [[BR]]HTTP请求方式:get [[BR]]是否需要登录:false [[BR]]返回格式:html [[BR]]缓存方式: [[BR]]缓存时间:60 [[BR]]说明: [[BR]]请求参数:[[BR]] ||参数名||类型||必须||说明|| ||modelId||int||Y||车型ID|| ||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||版本号|| === 2.3[=#point2.3 优惠详情] === [[BR]]mrobot请求url:{{{http://mrobot.pcauto.com.cn/xsp/s/auto/buy/v1.2/promotionDetail.xsp?marketId=7033340&modelId=33314&areaId=1}}} [[BR]]现应用接口： {{{ 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} }}} [[BR]]HTTP请求方式:get [[BR]]是否需要登录:false [[BR]]返回格式:html [[BR]]缓存方式: [[BR]]缓存时间:60 [[BR]]说明: [[BR]]请求参数:[[BR]] ||参数名||类型||必须||说明|| ||modelId||int||Y||车型ID|| ||marketId||int||Y||优惠ID|| ||areaId||int||Y||地区ID|| === 2.4 [=#point2.4 车型列表] === [[BR]]mrobot请求url:{{{http://mrobot.pcauto.com.cn/buy/price/getModelListBySerialId_v4_v12/{serialGroupId}?pageNo=1&pageSize=20&areaId=1}}} [[BR]]现应用接口： {{{ http://price.pcauto.com.cn/interface/iphone/atom/price/serial_group_basic_json.jsp?serialGroupId=8670 http://price.pcauto.com.cn/interface/iphone/atom/price/model_list_by_sg_json.jsp?serialGroupId=8670 http://price.pcauto.com.cn/interface/iphone/atom/dealer/model_list_news_price_json.jsp?serialGroupId=8670&rId=1; }}} [BR]原mrobot接口：{{{http://mrobot.pcauto.com.cn/v3/price/getModelListBySerialId_v4/8670?pageNo=1&pageSize=20&areaId=1}}} [[BR]]HTTP请求方式:get [[BR]]是否需要登录:false [[BR]]返回格式:json [[BR]]缓存方式: [[BR]]缓存时间:60 [[BR]]说明: [[BR]]请求参数:[[BR]] ||参数名||类型||必须||说明|| ||serialGroupId||int||Y||车型ID|| ||areaId||int||Y||地区ID|| [BR]返回结果： { "advantage": "动力输出流畅，后段爆发力足，整体隔音优秀", "bbsId": "17365", "brand": "奥迪", "brandId": "1", "disadvatage": "后排腿部空间和头部空间较为局促", "displacement": "1.4T 2.0T", "gearbox": "手动 双离合", "kind": "紧凑型SUV", "manufacturer": "一汽奥迪", "manufacturerId": "1", "photo": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1410/14/c4/39635392_39635392_1413256391078_120x90.jpg", "photoTotal": 2501, "photo_400x300": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1410/14/c4/39635392_39635392_1413256391078_400x300.jpg", "priceRange": "24.98~42.88万", "sections": [ { "data": [ { "config": "7挡双离合 前置前驱 ", "id": "33293", "introduce": 0, "isNews": "0", "photo": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1404/28/c15/33660207_1398675582054_120x90.jpg", "price": "28.98", "rjBzzw": 5, "state": "在售", "status": "在售", "title": "2015款 35 TFSI 进取型" } ], "serialGroupName": "奥迪Q3", "sgAverageScore": 4.33, "shareUrl": "http://price.pcauto.com.cn/sg8670/", "structure": "SUV" } ==================================================性能优化===================================================== === 3.1 [=#point3.1 车系参配] === [[BR]]mrobot请求url:http://mrobot.pcauto.com.cn/xsp/s/auto/buy/v1.2/serialDetail.xsp?serialId=4313&subscributedIds=30499,36337 [[BR]]现应用接口： {{{ http://dev3.pcauto.com.cn:8001/interface/iphone/atom/price/model_list_by_sg_json.jsp?serialGroupId=4313 车系概览页车型列表接口 http://dev3.pcauto.com.cn:8001/interface/iphone/atom/price/model_overview.jsp?mid=30499 车型概览接口 http://dev3.pcauto.com.cn:8001/interface/iphone/atom/price/model_params.jsp?mid=30499 车型参数接口 http://dev3.pcauto.com.cn:8001/dealer/interface/order/order_info.jsp?m=getMCountBySG&sgId=4313 订单数 }}} [[BR]]原接口： {{{ http://price.pcauto.com.cn/interface/iphone/model_list_v3.jsp?serialId=4313 }}} [[BR]]HTTP请求方式:get [[BR]]是否需要登录:false [[BR]]返回格式:html [[BR]]缓存方式: [[BR]]缓存时间:60 [[BR]]说明: [[BR]]请求参数:[[BR]] ||参数名||类型||必须||说明|| ||serialId||String||Y||车系ID|| ||subscributedIds||String||N||已订阅的车型id|| [[BR]]返回结果: { "detailArray": [ { "detail": [ { "groupDetail": [ "全国4S店", "2368笔" ], "groupName": "询价订单" }, { "groupDetail": [ "前制动器类型", "通风盘式", "后制动器类型", "通风盘式", "驻车制动类型", "电子驻车", "前轮胎规格", "245/45 R18 ", "后轮胎规格", "245/45 R18 ", "备胎规格", "非全尺寸" ], "groupName": "车轮制动" }... } ], "groupNameArray": [ "询价订单", "价格", "基本参数", "车身", "发动机", "电动机", ..... ] } === 3.2 [=#point3.2 车型对比] === [[BR]]mrobot请求url:{{{http://mrobot.pcauto.com.cn/xsp/s/auto/buy/v1.2/detailCompare.xsp?modelIds=34224,30502,30501,30500,30499&subscributedIds=30503,30499,30500}}} [[BR]]现应用接口： {{{ http://dev3.pcauto.com.cn:8001/interface/iphone/atom/price/model_overview.jsp?mid=30499 车型概览接口 http://dev3.pcauto.com.cn:8001/interface/iphone/atom/price/model_params.jsp?mid=30499 车型参数接口 http://dev3.pcauto.com.cn:8001/dealer/interface/order/order_info.jsp?m=getMCountBySG&sgId=4313 订单数 }}} [[BR]]原接口： {{{ http://price.pcauto.com.cn/interface/iphone/model_detail.jsp?mid=34224 }}} [[BR]]HTTP请求方式:get [[BR]]是否需要登录:false [[BR]]返回格式:html [[BR]]缓存方式: [[BR]]缓存时间:60 [[BR]]说明: [[BR]]请求参数:[[BR]] ||参数名||类型||必须||说明|| ||modelIds||String||Y||车型ID|| ||subscributedIds||String||N||已订阅的车型id|| [[BR]]返回结果: [[BR]]{ detailArray: [ { detail: [ { groupDetail: [ "全国4S店", "3473笔" ], groupName: "询价订单" }, ...... isSubscributed: false, metaUrl: "http://price.pcauto.com.cn/interface/iphone/model_detail.jsp?mid=30503", modelId: "30503", modelName: "奥迪A6L 2014款 30 FSI 舒适型 ", shortName: "30 FSI 舒适型" }, ...... } ] === 3.3 [=#point3.3 优惠列表] === [[BR]]PS:(加多了一个areaId参数,models里及里层的dealers里面添加totalPrice,giftPackage,modelType) [[BR]]mrobot请求url:{{{http://mrobot.pcauto.com.cn/xsp/s/auto/buy/v1.2/promotionList.xsp?areaId={}&pageNo=1&pageSize=20&sgId={serialId}&mfId={mfId}&modelId={modelId}}}} [[BR]]现应用接口： {{{ http://price.pcauto.com.cn/dealer/interface/app/market_json.jsp 基础数据包含models,dealers 增加三个字段：totalPrice全款购车 giftPackage 礼包 modelType //现车情况 amelistRange（// 销售范围，0:本市，1:本省，2:全国，3:售多市（用户自定义的，不作显示））出现非约定值 }}} [BR]原mrobot接口：{{{http://mrobot.pcauto.com.cn/buy/price/promotionList?pageNo=1&pageSize=10}}} [[BR]]HTTP请求方式:get [[BR]]是否需要登录:false [[BR]]返回格式:json [[BR]]缓存方式: [[BR]]缓存时间:60 [[BR]]说明: [[BR]]请求参数:[[BR]] ||参数名||类型||必须||说明|| ||areaId||int||Y||地区ID|| ||modelId||int||N||车型ID|| ||sgId||int||N||车系ID|| ||mfId||int||N||mfId|| [BR]返回结果： { "models": [ { "dealers": [ { "address": "广州市白云区机场路888号广物汽贸（别克销售中心）", "areaName": "白云区", "dealerId": 15269, "dealerPrice": 26.99, "discount": 0, "discountPrice": 26.99, "giftPackage": { "giftPackage": "", "giftPrice": "", "otherGift": "" }, "totalPrice":"12.33", "is400": 1, "is4S": 1, "latitude": "23.192980475373542", "longitude": "113.26646061581265", "modelType": "接受预定", "name": "广东物资君豪别克", "namelistRange": 0, "newsId": 6577743, "phone": "400-860-0462", "price": 26.99 }..... ], "discount": 0, "discountPrice": 26.99, "giftPackage": { "giftPackage": "", "giftPrice": "", "otherGift": "" }, "modelId": 34369, "modelType": "接受预定", "name": "昂科威 2015款 28T 四驱精英型 ", "photo": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1410/31/c10/40404789_40404789_1414750174280.jpg", "price": 26.99, "totalPrice":"12.99" } ], "pageCount": 2723, "pageNo": 1, "pageSize": 1, "total": 2723 } === 3.4 [=#point3.4 车型综述] === [[BR]]mrobot请求url:{{{http://mrobot.pcauto.com.cn/xsp/s/auto/buy/v1.2/model.xsp?modelId=3462&v=1.1.0&areaId=2&isCompared=0&isSubscribed=0}}} [[BR]]现应用接口： {{{ 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/atom/dealer/model_local_min_price.jsp?mid=" + modelId + "&rid=" + areaId http://price.pcauto.com.cn//interface/iphone/atom/dealer/model_list_news_price_json.jsp?serialGroupId="+jsonX.serialGorupId+"&rId="+areaId) }}} [BR]原mrobot接口：{{{http://mrobot.pcauto.com.cn/buy/price/model/34626?pageSize=20&pageNo=1;}}} [[BR]]HTTP请求方式:get [[BR]]是否需要登录:false [[BR]]返回格式:html [[BR]]缓存方式: [[BR]]缓存时间:60 [[BR]]说明: [[BR]]请求参数:[[BR]] ||参数名||类型||必须||说明|| ||areaId||int||N||地区ID|| ||modelId||int||N||车型ID|| ||v||string||N||版本号|| ||isCompared||int||N||是否已比较|| ||isSubscribed||int||N||是否已订阅|| === 3.5 [=#point3.5 车系综述] === [[BR]]mrobot请求url:{{{http://mrobot.pcauto.com.cn/xsp/s/auto/buy/v1.2/serial.xsp?v=1.1.0&areaId=3&isSubscribed=0&serialId=4313&modelIds=}}} [[BR]]现应用接口： {{{ 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://price.pcauto.com.cn/interface/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电话 }}} [BR]原mrobot接口：{{{http://mrobot.pcauto.com.cn/buy/price/serial/4313?v=1.1.0&areaId=3&isSubscribed=0&modelIds=；}}} [[BR]]HTTP请求方式:get [[BR]]是否需要登录:false [[BR]]返回格式:html [[BR]]缓存方式: [[BR]]缓存时间:60 [[BR]]说明: [[BR]]请求参数:[[BR]] ||参数名||类型||必须||说明|| ||areaId||int||Y||地区ID|| ||serialId||int||Y||车系id|| ||isSubscribed||int||N||是否订阅|| ||modelId||int||N||车型ID||