[[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），对象缓存（） 缓存时间：缓存时间 返回结果：结果可能情况 }}} == 2.接口列表 == === 2.1 找车 === ==== 2.1.1. 筛选-快速查找符合条件个数/列表==== (接口未上线） [[BR]]说明：此接口是在前版本的基础上新增了sortType的请求参数，用于指示返回结果的排序方式 [[BR]]备注：筛选条件变后，自动获取符合筛选条件的车型个数 [[BR]]1、用来请求找车首页的筛选条件 [[BR]]2、支持关联筛选，当用户的选择条件变更时，需要重新请求，请求的返回数据中：fact字段中，列出了每个筛选条件的可选值 [[BR]]3、list用来区分请求个数还是请求列表 [[BR]]Mrobot请求URL：http://mrobot.pcauto.com.cn/buy/price/search?rid=1&pageSize=20&pageNo=1&list=true&ps=0&sortType=1 [[BR]]后端请求测试URL： http://price.pcauto.com.cn/interface/iphone/query_car.jsp?rid=1&pageSize=20&pageNo=1&list=true&ps=0 [[BR]]后端请求正式URL： http://dev3.pcauto.com.cn:8001/interface/iphone/query_car.jsp?rid=1&pageSize=20&pageNo=1&list=true&ps=0&sort=1&asc=true [[BR]]HTTP请求方式：get [[BR]]是否需要登录：否 [[BR]]返回格式：json [[BR]]缓存方式：无 [[BR]]缓存时间：无 [[BR]]请求参数：无 ||参数名||类型||必须||说明|| ||rid||string||是||用户所在地区id|| ||list||string||是||筛选个数、筛选列表，取值true/false|| ||ps||string||否||最小价格|| ||pe||string||否||最大价格|| ||jb||string||否||级别|| ||pl||string||否||排量|| ||bsx||string||否||变速箱|| ||mkid||string||否||结构|| ||country||string||否||国别|| ||rl||string||否||燃料|| ||zw||string||否||座位|| ||qdfs||string||否||驱动|| ||pz||string||否||配置|| ||pageNo||string||否||分页|| ||pageSize||string||否||分页大小|| ||sortType||string||否||排序方式，1：按热度， 2：按价格由高到低，3：按价格由低到高，默认值为1|| 后端请求中参数sort=0表按热度，sort=1表按价格，desc只针对sort=1时有效，desc=true表降，false表升 === 2.2 优惠 === ==== 2.2.1. 优惠-优惠列表 ==== (接口已上线） [[BR]]说明：此接口与前版本区别在于，在返回结果的models成员元素中新增了几个字段，分别是giftPackage（礼包优惠），modelType（现车情况） [[BR]]Mrobot请求URL：http://mrobot.pcauto.com.cn/buy/price/promotionList?areaId=1&pageSize=20&pageNo=1 [[BR]]后端请求正式环境URL：http://price.pcauto.com.cn/dealer/interface/app/market_groupby_model_json.jsp [[BR]]后端请求测试环境URL：[[BR]]http://dev3.pcauto.com.cn:8001/dealer/interface/app/market_groupby_model_json.jsp?pageNo=1&pageSize=10&areaId=3 [[BR]]HTTP请求方式：get [[BR]]返回格式：json [[BR]]请求参数 {{{ areaId：城市id mfId: 厂商id sgId: 车系id modelId：车型id pageNo：第几页 pageSize：每页大小 callback：js回调函数名称 }}} 返回结果 {{{ { total: 143, //团购总数 pageCount: 15, //团购总页数 pageNo: 1, //第几页 pageSize: 10, //每页大小 models: [ //活动信息列表 { modelId: 7616, //车型id price: 7.78, // 车型官方价 name: "锐欧 2007款 1.4 手动 豪华型", //车型名称 discountPrice: 5.78, //促销价 discount : 20000, //降幅 giftPackage : "送10000元礼包", //礼包优惠 modelType : "现车充足", //现车情况 dealers:[ { dealerId : 32046, // 经销商ID name : 庞大东风悦达起亚, // 经销商简称 price : 7.78, //车型官方价 discountPrice: 5.78, //行情促销价 discount : 20000, //降幅 dealerPrice : 7.78, // 经销商报价 is4S : 1, // 是否4S店，1：是，0：否 is400 : 1, // 是否400电话，1：是，0：否 phone : 400-670-5680, //电话 namelistRange : 1 // 销售范围，0:本市，1:本省，2:全国 }, ... ] }, ... ] } }}} === 2.3 [=#point2.3 团购活动] === ==== 2.3.1 [=#point2.3.1 团购活动列表] ==== {{{ （QA测试连代理把mrobot.pcauto.com.cn重定向到v36.pcauto.com.cn） 请求mrobot接口：http://mrobot.pcauto.com.cn/buy/price/activityListv11?pageNo=1&pageSize=1®ionId=3 应用端接口：http://dev3.pcauto.com.cn:9977/autoMall/interface/auto_mall_gct_list_json.jsp?regionId=3 请求参数： regionId：城市ID（必须，默认值1） manufacturerId：车厂ID（可选） pageNo：页码（默认1） pageSize：每页条数（默认20） 返回结果： { "data": [ { "banner": "http://img.pconline.com.cn/images/upload/upc/tx/tuangou/1411/14/c0/34350_1415973025778_500x200.jpg", //购车团主图500x200px "beginTime": "2014/11/14 00:00:00", //开始时间 "brandName": "凯迪拉克(进口)", //车厂名称 "endTime": "2014/12/12 23:59:59", //结束时间 "id": 349, //购车团ID "maxDiscount": 5, //最高优惠,单位万. "orderCount": 2, //活动报名人数 "photo": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1403/18/c3/32200468_1395112948222_180x135.jpg", //最大优惠车系主图,180x135像素 "priceTitle": "最高优惠", //价格标题 "serialGroupNames": "凯迪拉克SRX", //车系名称串(最多5个) "title": "凯迪拉克厚惠无欺 万元优惠超值惊喜", //购车团标题 "url": "http://dev3.pcauto.com.cn:9977/gct/r3/g349/" //购车团链接 } ], "pageCount": 14, //总页数 "pageNo": 1, //页码 "pageSize": 1, //页面条数 "total": 14 //总条数 } }}} ==== 2.3.2 [=#point2.3.2 发起团购] ==== {{{ （QA测试连代理把mrobot.pcauto.com.cn重定向到v36.pcauto.com.cn） 请求方式：POST 请求mrobot接口：http://mrobot.pcauto.com.cn/v3/search/mallPost 应用端接口：http://dev3.pcauto.com.cn:9977/autoMall/gct/action/do_order.jsp 请求参数格式： key：param value： { "userName": "huixuan", "regionId": 1, "isInitMsg": 1, "origin": 3, "phone": 13360009613, "carSerialId" : 4313, "referer" : "http://mrobot.pcauto.com.cn/autobuy/" } 返回参数： ｛ code：200， msg：报名成功 ｝ 204 - 表单必填参数不完整 205 - 活动结束，不能报名 206 - 活动未审核，不能报名 207 - 活动审核失败，不能报名 500 - 系统错误 注意: （关于referer值）购车APP填写固定值:http://mrobot.pcauto.com.cn/autobuy/ 用于记录报名来源于购车app (关于carSerialId值）isInitMsg=1时为必须 参数说明如下表： }}} ||参数名称||参数名||类型||说明||是否必须|| ||经销商ID||dealerId||Long||默认0||必须|| ||网友姓名||userName||String|| ||必须|| ||网友城市||regionId||Long|| ||必须|| ||网友电话||phone||String|| ||必须|| ||来源URL||referer||String||见注意||必须|| ||平台来源||origin||int||0未知,1:web,2:wap,3:IOS,4:Android,5:WP,6:杂志||必须|| ||是否三人行||isInitMsg||int||0:购车团报名,1:三人行||必须|| ||APP应用ID||appKey||String|| ||非必须|| ||来源渠道ID||chId||String|| ||非必须|| ||设备ID||devId||String|| ||非必须|| ||车系ID||carSerialId||long||isInitMsg=1时为必须||必须|| ==== 2.3.3 [=#point2.3.3 团购活动详情页] ==== （QA测试连代理把mrobot.pcauto.com.cn重定向到v36.pcauto.com.cn） [[BR]]请求URI： http://mrobot.pcauto.com.cn/buy/price/activityDetail/{id}?areaId=1&modelId=0&modelId=0&name=text&tel=13455455545&dId=364171E5-73FE-4907-9C3F-F5D47B355F2F&origin=${origin} [[BR]]示例：http://mrobot.pcauto.com.cn/buy/price/activityDetail/347?areaId=3&modelId=0&name=text&tel=13455455545&dId=C592AA63-9758-4594-B161-2B5780F89F40&origin=1 [[BR]]HTTP请求方式：GET [[BR]]返回格式：html [[BR]]请求参数： ||参数名||类型||必须||说明|| ||id||number||YES||团购活动id|| ||areaId||number||YES||城市id|| ||modelId||number||NO||车型id，没有情况下传0|| ||dId||string||YES||设备id|| ||name||string||YES||用户的名字|| ||tel||string||YES||用户的电话号码|| 跳转协议：[[BR]] 点击提交信息按钮协议：pcaction://tuan-detail-click-result?name=xx&tel=xx&code=xxx name：用户的姓名[[BR]] tel：用户的电话号码[[BR]] code：提交后返回的状态码 code的规则：[[BR]] 200 - 报名成功[[BR]] 204 - 表单必填参数不完整[[BR]] 205 - 活动结束，不能报名[[BR]] 206 - 活动未审核，不能报名[[BR]] 207 - 活动审核失败，不能报名[[BR]] 500 - 系统错误[[BR]] === 2.4 询底价|我要优惠 === ==== 2.4.1 询底价 ==== 备注：接口已上线 [[BR]]说明：此接口是在前版本的基础上新增了几个请求参数，分别是name、tel、isMain、v [[BR]]Mrobot请求URL： http://mrobot.pcauto.com.cn/buy/price/askprice?v=1.1.0&serialId={车系id}&modelId={车型id}&modelName={车系名+车型名}&areaId={城市id}&dealerId={经销商id} [[BR]]示例：http://mrobot.pcauto.com.cn/buy/price/askprice?v=1.1.0&serialId=4313&modelId=30499&modelName=%E5%A5%A5%E8%BF%AAA6L%202014%E6%AC%BE%202.0%20TFSI%20%E6%89%8B%E5%8A%A8%E5%9F%BA%E6%9C%AC%E5%9E%8B&areaId=3&dealerId=0&isMain=1 HTTP请求方式：get[[BR]] 是否需要登录：否[[BR]] 返回格式：html页面[[BR]] 缓存方式：无[[BR]] 缓存时间：无[[BR]] 请求参数[[BR]] ||参数名||类型||必须||说明|| ||serialId||string||是||车系id|| ||modelId||string||是||车型id|| ||modelName||string||是||车系名称+车型名称|| ||areaId||string||是||城市id|| ||dealerId||string||是||经销商id，由车系综述页进入询底价页时，取0；由车型综述页中的经销商列表进入询底价页时，取对应的经销商id值|| ||name||string||否||询价者姓名，不为空时“询底价页”的姓名一栏会填入该值|| ||tel||string||否||询价者手机号，不为空时“询底价页”的手机号一栏会填入该值|| ||appKey||string||否||应用id，即应用的魔方key|| ||chId||string||否||来源渠道id，如应用在苹果商店下载安装的，取值为"app_store"|| ||devId||string||否||设备id|| ||referer||string||否||来源url，详见附件《汽车报价宝典线索入口来源对应参数表（重要）.txt》|| ||isMain||string||否||是否需要提供车型选择的跳转协议，0：不需提供，1：需提供，跳转协议为：pcaction://choose-car/。注：只有当dealerId为0时该参数有效|| ||v||string||是||接口版本，固定取值"1.1.0"|| 补充说明： 1.当从车系综述页进入询底价页时，经销商已选择的个数超过选择上限（3个）的跳转协议为：pcaction://showtip/，可用于触发APP端的提示；[[BR]] 2.html页中带有javascript方法 function setCar(modelId,modelName)，可用于修改询底价页在切换车型后的车型信息更改； 页面内协议说明： ||协议串||说明|| ||pcaction://choose-car/||车型选择|| ||pcaction://showtip/||经销商的选择个数超过上限，APP的提示文案为"最多选择3个经销商"（注：协议串不带文案信息）|| ==== 2.4.2 我要优惠 ==== 备注：接口已上线 [[BR]]说明：此接口是在前版本的基础上新增了几个请求参数，分别是name、tel、v [[BR]]Mrobot请求URL： http://mrobot.pcauto.com.cn/buy/price/getPromotion?v=1.1.0&serialId={车系id}&modelId={车型id}&modelName={车系名+车型名}&areaId={城市id}&dealerId={经销商id} [[BR]]示例：http://mrobot.pcauto.com.cn/buy/price/getPromotion?v=1.1.0&modelId=20062&modelName=%E5%A5%A5%E8%BF%AAA6L%202012%E6%AC%BE%202.5%2030FSI%20%E6%8A%80%E6%9C%AF%E5%9E%8B&serialId=4313&areaId=1&dealerId=65469&name=tt&tel=13588888888&appKey=34ca62060a1474350000052f&chId=app_store&devId=cb2039424107a8f6d3847fd390d81e60ba7ab516&referer=sg_discount HTTP请求方式：get[[BR]] 是否需要登录：否[[BR]] 返回格式：html页面[[BR]] 缓存方式：无[[BR]] 缓存时间：无[[BR]] 请求参数[[BR]] ||参数名||类型||必须||说明|| ||serialId||string||是||车系id|| ||modelId||string||是||车型id|| ||modelName||string||是||车系名称+车型名称|| ||areaId||string||是||城市id|| ||dealerId||string||是||经销商id|| ||name||string||否||询价者姓名，不为空时“我要优惠”页的姓名一栏会填入该值|| ||tel||string||否||询价者手机号，不为空时“我要优惠”页的手机号一栏会填入该值|| ||appKey||string||否||应用id，即应用的魔方key|| ||chId||string||否||来源渠道id，如应用在苹果商店下载安装的，取值为"app_store"|| ||devId||string||否||设备id|| ||referer||string||否||来源url，详见附件《汽车报价宝典线索入口来源对应参数表（重要）.txt》|| ||v||string||是||接口版本，固定取值"1.1.0"|| === 2.5 车系 === ==== 2.5.1.车系-综述 ==== 备注：接口已上线 [[BR]]说明：此接口是在前版本的基础上新增了请求参数v [[BR]]请求URL： http://mrobot.pcauto.com.cn/buy/price/serial/{id}?v=1.1.0&areaId={cityid}&isSubscribed={1、0}&modelIds={1，2，3} [[BR]]例子：http://mrobot.pcauto.com.cn/buy/price/serial/4313?v=1.1.0&areaId=3&isSubscribed=0&modelIds= [[BR]]HTTP请求方式：get[[BR]] 是否需要登录：否[[BR]] 返回格式：html页面[[BR]] 缓存方式：无[[BR]] 缓存时间：无[[BR]] 请求参数 ||参数名||类型||必须||说明|| ||seriesid||string||是||车系id|| ||isSubscribed||string||是||是否已经订阅了车系，取值0、1|| ||modelIds||string||是||本地已经加入对比的车型id列表，逗号隔开|| ||v||string||是||接口版本，固定取值"1.1.0"|| 页面内数据说明：在返回的页面里添加了注释数据/*@_HTML_META_START_（数据部分）_HTML_META_END_@*/ [[BR]] 数据内容为： {{{ { "kind": "中大型车", "photo": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1410/28/c2/40229017_40229017_1414462821712_120x90.jpg", "priceRange": "38.30~74.26万", "cars":[ { "data": [ { "config": "6挡手动 前置前驱 车身稳定控制 天窗", "dealerName": "上海晨安奥迪", "dealerPhone": "400-860-3273", "discount": "8.63", "id": "30499", "is400": 1, "isNews": "0", "minPrice": "29.67", "photo": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1208/21/c7/13077074_13077074_1345530200671_120x90.jpg", "price": "38.3", "state": "在售", "status": "在售", "title": "2014款 2.0 TFSI 手动基本型", "vendorPrice": "31.02~38.30" }, "title": " 2.0T 涡轮增压 180马力" }, .... ] } }}} 数据字段说明： 1.kind、photo、priceRange，可用于 从热搜进入车系页再进行“订阅”时的数据保存，以免跳转到“我的订阅”时出现相关信息无法显示的问题； 2.cars，用于从针对车系的“询底价”按钮 进入“询底价页”，页面的“意向车型”的车型列表数据； ==== 2.5.2.车系-优惠 ==== http://trac.pc.com.cn/iphone/wiki/pcauto_BuyAuto_1.1.0#a2.2.1.优惠-优惠列表 === 2.6 车型 === ==== 2.6.1.车型-综述 ==== 备注：接口已上线 [[BR]]说明：此接口是在前版本的基础上新增了请求参数v [[BR]]请求URL： http://mrobot.pcauto.com.cn/buy/price/models/{id}?v=1.1.0&areaId=1&isCompared=0&isSubscribed=0 [[BR]]例子：http://mrobot.pcauto.com.cn/buy/price/models/30499?v=1.1.0&areaId=1&isCompared=0&isSubscribed=0 [[BR]]HTTP请求方式：get[[BR]] 是否需要登录：否[[BR]] 返回格式：html页面[[BR]] 缓存方式：无[[BR]] 缓存时间：无[[BR]] 请求参数 ||参数名||类型||必须||说明|| ||id||string||是||车型id|| ||areaId||string||是||城市id|| ||isCompared||string||是||是否本地已经添加对比，取值0、1|| ||isSubscribed||string||是||是否本地已经添加订阅，取值0、1|| ||v||string||是||接口版本，固定取值"1.1.0"|| 页面内协议说明 ||协议串||说明||