== 接口文档 == [[TOC]] === 2.0 辅助接口 === ==== 2.0.1.城市切换(已有接口)==== 获取可切换的城市列表[[BR]] {{{ }}} ==== 2.0.2. 获取当前用户的可团购车系列表 ==== 请使用： http://trac.pc.com.cn/iphone/wiki/pcauto_BuyAuto_1.0.0#a2.6.1.团购-团购列表含筛选 === 2.1 车型库 === ==== 2.1.1.车型库-品牌列表==== 备注：获取车型库品牌列表 [[BR]]Mrobot请求URL：http://mrobot.pcauto.com.cn/v2/price/brands [[BR]]请求后端URL：http://price.pcauto.com.cn/interface/iphone/brand_list.jsp, [[BR]]HTTP请求方式：get [[BR]]是否需要登录：否 [[BR]]返回格式：json [[BR]]缓存方式：无 [[BR]]缓存时间：1天 [[BR]]请求参数：无 ==== 2.1.2.车型库-品牌-车系列表 ==== 备注：通过品牌ID得到车系列表 [[BR]]Mrobot请求URL：http://mrobot.pcauto.com.cn/v3/price/getSerialListByBrandId/1?type=1 [[BR]] HTTP请求方式：get [[BR]] 是否需要登录：否 [[BR]] 返回格式：json [[BR]] 缓存方式：无 [[BR]] 缓存时间：5分钟 [[BR]] 请求参数： ||参数名||类型||必须||说明|| ||bid||number||YES||品牌id 返回参数，需要增加一个字段： {{{ { "manufacturers":[ { "brandName":"奥迪", "name":"一汽奥迪", "brandIntroduction":"http://price.pcauto.com.cn/qcbk/ppgs/Audi/1208/2068630.html", "serials":[ { "id":3524, "name":"奥迪A4L", "kind":"中型车", "priceRange":"27.28~57.81 万", "isNew":0, "sellStatus":3, "photo":"http://www1.pcauto.com.cn/piclib/20000/nEO_IMG_3524.jpg", "count":41 },...] }...] } }}} ==== 2.1.3.车型库->车系->车型列表 ==== 备注：通过车系ID得到车型列表 [[BR]]请求URL：http://mrobot.pcauto.com.cn/v3/price/getModelListBySerialId_v4/3524 [[BR]] HTTP请求方式：get [[BR]] 是否需要登录：否 [[BR]] 返回格式：json [[BR]] 缓存方式：无 [[BR]] 缓存时间：5分钟 [[BR]] 请求参数： ||参数名||类型||必须||说明|| ||bid||number||YES||品牌id 返回参数，需要增加一个字段： {{{ }}} ==== 2.1.4.车型库-热销排行榜 ==== 备注： [[BR]]Mrobot正式URL ：http://mrobot.pcauto.com.cn/buy/price/hotSellSerials/1?pageNo=1&pageSize=20 [[BR]]请求后端URL(开发)：http://v17.pcauto.com.cn:8002/interface/iphone/praiselist_by_kindId.jsp?kindId=1&pageNo=1&pageSize=10 [[BR]]请求后端URL(线上)：http://price.pcauto.com.cn/interface/iphone/praiselist_by_kindId.jsp?kindId=3&pageNo=1&pageSize=10 [[BR]]HTTP请求方式：get [[BR]]是否需要登录：否 [[BR]]返回格式：json [[BR]]缓存方式：无 [[BR]]缓存时间：无 [[BR]]请求参数 ||参数名||类型||必须||说明|| ||kindId||number||是||1~8分别代表：紧凑型车、SUV、中型车、小型车、微型车、中大型车、豪华型车、MPV|| ||page||number||是||请求分页|| ||pagesize||number||是||请求分页大小|| 返回参数 {{{ { "total":146, "list":[ { "price":"12.38-16.08万", "serialGroupId":"2734", "serialGroupName":"卡罗拉", "photo":"http://www1.pcauto.com.cn/piclib/20000/nEO_IMG_2734.jpg" },...] } }}} ==== 2.1.4.车型库-搜索-关键词==== 备注：动态获取搜索关键字，由编辑在cms里维护 [[BR]]Mrobot请求URL：http://mrobot.pcauto.com.cn/buy/price/modelsForSearch [[BR]]请求后端URL（线上）：http://www.pcauto.com.cn/client/news/tghd/1409/intf4687.js [[BR]]HTTP请求方式：get [[BR]]是否需要登录：否 [[BR]]返回格式：json [[BR]]缓存方式：无 [[BR]]缓存时间：无 [[BR]]请求参数：无 [[BR]]返回参数： {{{ { "modelList": [{ "id": 123, "name": "蒙迪欧" }] } }}} ==== 2.1.5 车型库-车系搜索 ==== 备注： [[BR]]Mrobot请求URL：http://mrobot.pcauto.com.cn/v3/price/models/search?keyword=大众&pageNo=1&pageSize=1000 [[BR]]请求后端URL： http://price.pcauto.com.cn/interface/iphone/search_serial_group_list.jsp?pageNo=1&pageSize=1000&keyword=大众 [[BR]]HTTP请求方式：get [[BR]]是否需要登录：否 [[BR]]返回格式：json [[BR]]缓存方式：无 [[BR]]缓存时间：无 [[BR]]请求参数: ||参数名||类型||必须||说明|| ||keyword||string||YES||查询条件|| ||pageNo||number||YES||页码|| ||pageSize||number||YES||一页条数|| ==== 2.1.6 车型库-根据车型id查询车型详细 ==== 备注： [[BR]]Mrobot请求URL：http://mrobot.pcauto.com.cn/buy/price/modelMessage [[BR]]请求后端URL（线上）：http://price.pcauto.com.cn/interface/iphone/model_detail.jsp?mid=1&haveDealerPrice=0&haveBuyCarPrice=0&haveParameter=0 [[BR]]HTTP请求方式：get [[BR]]是否需要登录：否 [[BR]]返回格式：json [[BR]]缓存方式：无 [[BR]]缓存时间：无 [[BR]]请求参数: ||参数名||类型||必须||说明|| ||modelId||string||YES||车型id|| ||callback||number||NO||为解决js跨域问题，可不传|| [[BR]]返回参数： {{{ { id = 21804; // 车型id kind = "\U4e2d\U578b\U8f66"; // 所属车系的车系类型（如紧凑型、xx型等） photo = "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1312/30/c19/30133161_1388384673038_120x90.jpg"; // 车型图片 price = "29.1"; // 车型价格 serialId = 3524; // 所属车系车系id serialName = "\U5965\U8feaA4L"; // 所属车系名称 serialSubName = "\U4e00\U6c7d\U5965\U8fea"; // 所属车系的车系品牌（如：一汽大众、一汽奥迪、AC宝马） modelName = "2013\U6b3e 1.8 30TFSI \U81ea\U52a8\U8212\U9002\U578b"; // 车型名称 } }}} === 2.2 车系 === ==== 2.2.1.车系-综述 ==== 备注： 请求URL： http://mrobot.pcauto.com.cn/buy/price/serial/{id}?areaId={cityid}&isSubscribed={1、0}&modelIds={1，2，3} HTTP请求方式：get[[BR]] 是否需要登录：否[[BR]] 返回格式：html页面[[BR]] 缓存方式：无[[BR]] 缓存时间：无[[BR]] 请求参数 ||参数名||类型||必须||说明|| ||seriesid||string||是||车系id|| ||isSubscribed||string||是||是否已经订阅了车系，取值0、1|| ||modelIds||string||是||本地已经加入对比的车型id列表，逗号隔开|| ==== 2.2.2.车系-优惠 ==== http://trac.pc.com.cn/iphone/wiki/pcauto_BuyAuto_1.0.0#a2.5优惠 ==== 2.2.3.车系-参配 ==== 备注： 请求URL： http://mrobot.pcauto.com.cn/buy/price/serialDetail/{id}?subscributedIds=1,2,3 [[BR]] HTTP请求方式：get[[BR]] 是否需要登录：否[[BR]] 返回格式：html页面[[BR]] 请求参数 ||参数名||类型||必须||说明|| ||id||string||是||车系id|| ||subscributedIds||string||是||本地已经加入订阅的车型id列表，如：1，2，3|| ==== 2.2.4.车系-点评 ==== [[BR]]备注：（资讯客户端的车主点评列表）获取某车系下的车主点评列表。接口为网页，点击网页中列表，跳转协议为：pcaction://pcauto-owner-review?modelId=${id} [[BR]]请求URL：http://mrobot.pcauto.com.cn/buy/price/commentList/{serialId} [[BR]]HTTP请求方式：get [[BR]]是否需要登录：否 [[BR]]返回格式：html页面 [[BR]]缓存方式：无 [[BR]]缓存时间：无 {{{ 请求参数： serialId：车系id }}} ==== 2.2.5.车系-资讯列表 ==== 请求URL： http://mrobot.pcauto.com.cn/buy/price/getArticlesBySerialId/{serialId}?pageNo=1&pageSize=20&type=0 [[BR]] HTTP请求方式：get[[BR]] 是否需要登录：否[[BR]] 返回格式：json[[BR]] 缓存方式：无[[BR]] 缓存时间：无[[BR]] 请求参数 ||参数名||类型||必须||说明|| ||serialId||string||是||车系id|| ||page||number||是||分页页码|| ||pagesize||number||是||分页大小|| ||type||number||是||资讯类型：0、全部、1、评测 2、导购 || ||返回参数|| ||参数名||类型||必须||说明|| ||total||number||yes||资讯总个数|| ||data||array||yes||资讯列表分页数据|| || ||列表项格式|| || ||参数名||类型||必须||说明|| || ||id||string||是||文章id|| || ||image||string||是||文章导读图|| || ||title||string||是||文章标题|| || ||channelName||string||是||栏目名|| || ||pubDate||string||是||文章发布时间|| ==== 2.2.6.车系-资讯文章 ==== 请求URL：http://mrobot.pcauto.com.cn/buy/cms/articles/{id}?size=18&picRule=2 [[BR]] HTTP请求方式：get[[BR]] 返回格式：html[[BR]] 请求参数 ||参数名||类型||必须||说明|| ||id||string||是||文章id|| ||size||number||是||字体大小|| ||picRule||number||是||图片模式|| ||pageNo||number||分页|| === 2.3 车型 === ==== 2.3.1.车型-综述 ==== 备注： 请求URL： http://mrobot.pcauto.com.cn/buy/price/models/{id}?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|| ||返回参数|| ||参数名||类型||必须||说明|| 页面内协议说明 ||协议串||说明|| ==== 2.3.2.车型-参配 ==== 请求URL： http://mrobot.pcauto.com.cn/buy/price/modelDetail/{modelid} [[BR]] HTTP请求方式：get[[BR]] 是否需要登录：否[[BR]] 返回格式：html页面[[BR]] 缓存方式：无[[BR]] 缓存时间：无[[BR]] 请求参数 ||参数名||类型||必须||说明|| ||modelid||string||是||车型id|| {{{ 备注： 要做参配导航的情况下：配合如下接口请求参配导航的目录 http://mrobot.pcauto.com.cn/buy/price/modelDetail?fmt=json 然后当当点击某个目录后，调用js来让web导航： js名称： setPosition(1)// 1为导航菜单的id }}} ==== 2.3.3.车型-点评（资讯客户端的车主点评） ==== {{{ 备注：车主点评终端页 请求URL：http://mrobot.pcauto.com.cn/buy/price/commentDetail/{modelId}?pageNo=1 HTTP请求方式：get 是否需要登录：否 返回格式：html页面 缓存方式：无 缓存时间：无 请求参数： modelId 车型id pageNo 当前分页 }}} ==== 2.3.4.车型-团购/陪购 ==== 备注： 请求URL： 待定 [[BR]] HTTP请求方式：get[[BR]] 是否需要登录：否[[BR]] 返回格式：html页面[[BR]] 缓存方式：无[[BR]] 缓存时间：无[[BR]] 请求参数 ||参数名||类型||必须||说明|| ||modelid||string||是||车系id|| ||返回参数|| ||参数名||类型||必须||说明|| ||-||-||-||-|| ||页面内协议说明|| ||参数名||类型||必须||说明|| ||-||-||-||-|| ==== 2.3.5.车型-优惠详情 ==== 请使用： http://trac.pc.com.cn/iphone/wiki/pcauto_BuyAuto_1.0.0#a2.5.2.优惠-详细 === 2.4 找车 === ==== 2.4.1. 筛选-精准选车条件 ==== 备注： [[BR]]Mrobot正式URL ：http://mrobot.pcauto.com.cn/buy/price/chooseOption [[BR]]后端请求测试URL：http://v17.pcauto.com.cn:8002/interface/iphone/price_choose_option.jsp [[BR]]后端请求正式URL：http://price.pcauto.com.cn/interface/iphone/price_choose_option.jsp [[BR]]HTTP请求方式：get [[BR]]是否需要登录：否 [[BR]]返回格式：json [[BR]]缓存方式：无 [[BR]]缓存时间：无 [[BR]]请求参数：无 [[BR]]返回参数说明： {{{ 1、级别-jb => 76-微型车（详细信息请参考接口数据） 2、排量-pl 3、变速箱-bsx 4、结构-mkid 5、国别-country 6、燃料-rl 7、座位-zw 8、驱动-qdfs 9、自定义价格 最低价-ps 10、自定义价格 最高价-pe }}} ==== 2.4.2. 筛选-快速查找符合条件个数/列表==== 备注：筛选条件变后，自动获取符合筛选条件的车型个数 [[BR]]1、用来请求找车首页的筛选条件 [[BR]]2、支持关联筛选，当用户的选择条件变更时，需要重新请求，请求的返回数据中：fact字段中，列出了每个筛选条件的可选值 [[BR]]3、list用来区分请求个数还是请求列表 [[BR]]Mrobot请求URL： http://mrobot.pcauto.com.cn/buy/price/search?rid=1&list=true&jb=72&pageSize=20&pageNo=1 [[BR]]后端请求测试URL： http://v17.pcauto.com.cn:8002/interface/iphone/query_car.jsp [[BR]]后端请求正式URL： [[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||否||分页大小|| === 2.5 优惠 === ==== 2.5.1. 优惠-优惠列表 ==== [[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]] [[BR]]后端请求环境URL： [[BR]]http://v17.pcauto.com.cn:8002/dealer/interface/app/market_groupby_model_json.jsp [[BR]]HTTP请求方式：get [[BR]]返回格式：json [[BR]]请求参数 {{{ areaId：城市id [[BR]] mfId: 厂商id [[BR]] sgId: 车系id [[BR]] modelId：车型id [[BR]] pageNo：第几页 [[BR]] pageSize：每页大小 [[BR]] callback：js回调函数名称 [[BR]] }}} 返回结果 {{{ { total: 143, //团购总数 pageCount: 15, //团购总页数 pageNo: 1, //第几页 pageSize: 10, //每页大小 models: [ //活动信息列表 { modelId: 7616, //车型id price: 7.78, // 车型官方价 name: "锐欧 2007款 1.4 手动 豪华型", //车型名称 discountPrice: 5.78, //促销价 discount : 20000, //降幅 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.5.2. 优惠-详细 ==== 获取优惠详情数据 [[BR]]Web页面请求地址：http://mrobot.pcauto.com.cn/buy/price/promotionDetail/5529226?areaId=1&modelId=23885 [[BR]]请求参数：marketId 商家行情id ||id||string||否||优惠、行情id|| ||areaId||string||否||城市id|| ||modelId||string||否||车型id，如果没有，传0|| [[BR]]返回数据格式：Html页面 {{{ 后端请求地址： 测试: http://dev3.pcauto.com.cn:8001/dealer/interface/app/dealer_market_json.jsp 正式：http://price.pcauto.com.cn:/dealer/interface/app/dealer_market_json.jsp 返回数据 { “deadline”:”2014-04-30”, //截止日期 “isShow24Icon”:””, // 是否24小时营业, 1:是，0:否 “is400”:1, // 是否400电话，1:是，0:否 “phone”:”123456” ,//电话 “discountInfo”:{ "dealerId": "2014.04.09-2014.04.30", // 经销商ID "expiry": "2014.04.09-2014.04.30", //有效期 "shortInfo": "", //短标题 "info": "进口大众广州鸿众店内高尔夫(进口)现车充足，近期购车最高优惠10万。", }, "models": [ { "modelId": "高尔夫(进口) 2012款 1.4T 舒适敞篷版", "modelName": "高尔夫(进口) 2012款 1.4T 舒适敞篷版", "price": "34.98万", //官方价 "nowPrice": "24.98万", //现价 "discount": "10万", //降幅 "quantity": "充足", // 车型数量情况 "isReplace": "0", //是否含旧车优惠，1:是，0:否 "decline": "", // 行情优惠降幅 }, ...... ], addModels:[ { "modelId": "" //加装车id "modelName": "", //加装车名称 "price": "", //加装车车型的官方价 "addPrice": "", //加装车售价 "config": "{addConfig: , otherConfig: }", //加装车配置 }, ...... ] "images": [ "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1305/21/c1/21155361_1369114292031_500.jpg", "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1305/21/c1/21155361_1369114385703_270x202.jpg" ] } }}} ==== 2.5.3. 推荐经销商 ==== {{{ 获取推荐经销商（公共询价报名页，web页面调用，app未使用到） 正式环境URL：（已上线） http://price.pcauto.com.cn/dealer/interface/order/recommend_dealer.jsp 测试环境URL： http://dev3.pcauto.com.cn:8001/dealer/interface/order/recommend_dealer.jsp HTTP请求方式：get 返回格式：json 请求参数 rid：城市ID【必填】 sgid：车系id【必填】 type: 名单类型（询价报名固定为0即可）【必填】 callback：回调函数 返回结果 [ { "vip":-1, "dealerId":55342, "phone":"400-881-0693", "isShow24Icon":1, "areaName":"龙华新区", "range":0, "phoneType":1, "address":"龙华新区金龙路（梅林关口）上河坊购物乐园首层国汽名车广场", "name":"深圳国汽宝马", "agent":"4S店" }... ] }}} === 2.6 团购 === ==== 2.6.1. 团购-团购列表(含筛选) ==== 备注： [[BR]]请求URL： 正式环境URL：http://mai.pcauto.com.cn/gct/interface/get_gct_activity_list.jsp?regionId=1 [[BR]] 测试环境URL：http://v37.pcauto.com.cn:8080/gouchetuan/interface/get_gct_activity_list.jsp?regionId=1 [[BR]] Mrobot请求URL：http://mrobot.pcauto.com.cn/buy/price/activityList?regionId=1&pageSize=20&pageNo=1 [[BR]] HTTP请求方式：get[[BR]] 是否需要登录：否[[BR]] 返回格式：json[[BR]] 缓存方式：无[[BR]] 缓存时间：无[[BR]] 请求参数 ||参数名||类型||必须||说明|| ||serialIds||string||否||筛选条件，如果全部车型，则为空，多个车系的情况，以，号隔开|| ||regionId||string||是||城市id|| ||filter||string||是||filter=1，必填|| ||provinceId||string||是||省份id|| ||manufacturerId||string||否||厂商id|| ||page||number||是||请求分页|| ||pagesize||number||是||请求分页大小|| 返回示例: {{{ { total: 143, //团购总数 pageCount: 15, //团购总页数 pageNo: 1, //第几页 pageSize: 10, //每页大小 data: [ //活动信息列表 { id: 4702, //团购活动id person: 7, //参加团购活动人数 title: "别克厂家直销会 百万钜惠让利等你来", //团购活动标题 price: "17.5", //显示价格 image: "HYPERLINK "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1310/28/c19/28064316_1382955211312_350x260.jpg"http://img.pconline.com.cn/images/upload/upc/tx/auto5/1310/28/c19/28064316_1382955211312_350x260.jpg", //车系图片 serialName: "君威", //车系名称 deadline: "2014-08-02", //截止时间 discount: "25000" //优惠价格 }, ... ] } }}} ==== 2.6.3. 团购-活动详细 ==== [[BR]]请求URI：http://mrobot.pcauto.com.cn/buy/price/activityDetail/{id}?areaId=1&modelId=0&dId=364171E5-73FE-4907-9C3F-F5D47B355F2F [[BR]]HTTP请求方式：get [[BR]]返回格式：html [[BR]]请求参数 ||参数名||类型||必须||说明|| ||id||number||YES||团购活动id|| ||areaId||number||YES||城市id|| ||modelId||number||YES||车型id，没有情况下传0|| ||dId||number||YES||设备id|| web页面数据后端请求接口： {{{ 正式环境URL：http://mai.pcauto.com.cn/gct/interface/get_gct_activity_detail.jsp?tsgId=4702 测试环境URL：http://dev3.pcauto.com.cn:9977/gouchetuan/interface/get_gct_activity_detail.jsp?tsgId=141 }}} 后端返回参数 {{{ { "models":[ //团购活动车型列表 {"modelId":28740, //车型id "modelName":"君威 2014款 1.6T 时尚技术型", //车型名 "price":19.989999771118164, //车型价格 "discountPrice":17.489999771118164, //车型优惠价 "discount":2.5 //车型优惠幅度 },...], "id":4702, //团购活动id "dealerId":15964, //经销商id "person":7, //活动参与人数 "title":"别克厂家直销会 百万钜惠让利等你来", //活动标题 "activityInfo":"...", //活动详情 "serialId":3543, //车系id "image":"http://img.pconline.com.cn/images/upload/upc/tx/auto5/1310/28/c19/28064316_1382955211312_350x260.jpg", //车系图片 "serialName":"君威", //车系名 "deadline":"2014-08-02", //截止时间 "grouponInfo":[ //团购信息列表 {"text":"2000豪礼，1000元油卡等着你","name":"现场抽奖"}, {"text":"18期0利率，2-3年低利率","name":"贷款优惠"} ], "city":"广东 广州" //活动城市 } }}} ==== 2.6.3. 团购报名接口信息 ==== {{{ （web端加入团购后，需要同步给微信推送平台的接口，app没用到） 未上线 测试url : http://v12.pcauto.com.cn:8004/interface/app/do_autobuyOrder.jsp 正式url : http://wxzs.pcauto.com.cn/interface/app/do_autobuyOrder.jsp PS:团购活动ID测试环境请使用:61,91,137,142,151,161 . 参数描述: @param callback 回调函数名,选填 @param dId 设备ID,必填 @param acId 团购活动ID,必填 @return json 例: {"msg":"报名成功!","result":true} }}} ==== 2.6.4. 三人行报名接口 （发起团购的接口）==== {{{ 正式环境URL：（已上线 注：正式环境的报名数据会派发给经销商，测试开发过程慎用） http://mai.pcauto.com.cn/gct/action/do_order.jsp?req-enc=utf-8 测试环境URL： http://v37.pcauto.com.cn:8080/gouchetuan/action/do_order.jsp?req-enc=utf-8 HTTP请求方式：post 返回格式：json 请求参数 carSerialId：车系ID【必填】 userName：报名人名称【必填】 phone：报名人电话【必填】 regionId：城市id【必填】 provinceId：省份id【选填】 origin：平台来源,0:未知,1:web,2:wap,3:IOS,4:Android,5:WP,6:杂志【必填】 isInitMsg:1,【三人行报名，固定为1】 referer：来源URL（当前页面的url）【必填】（购车APP填写固定值:http://mrobot.pcauto.com.cn/autobuy/ 用于记录报名来源于购车app） 返回参数 { code:200 //报名成功 } 204 - 表单必填参数不完整 500 - 系统错误 }}} ==== 2.6.5. 团购投诉接口信息 ==== {{{ 说明： 使用post方式请求 测试请求url： http://v17.pcauto.com.cn:8002/dealer/interface/tuangou/tuangou_report.jsp 上线后请求url: http://price.pcauto.com.cn/dealer/interface/tuangou/tuangou_report.jsp 参数： name:投诉人姓名 phone:投诉人电话 content:投诉内容 _charset：字符编码(取值utf-8) callback:回调函数名称(可以不传，按具体情况使用) 返回值： 不传callback参数 成功返回：{"status":"success"} 失败返回：{"status":"error"} 传callback参数 成功返回：callback_name({"status":"success"}) 失败返回：callback_name({"status":"error"}) }}} ==== 2.6.5. 获取车系/车型最近30天4S店报名人数==== {{{ （Web用到，app未用到） 获取车系/车型最近30天4S店报名人数 正式环境URL：（已上线） http://price.pcauto.com.cn/dealer/interface/order/order_info.jsp 测试环境URL： http://dev3.pcauto.com.cn:8001/dealer/interface/order/order_info.jsp HTTP请求方式：get 返回格式：json 请求参数 m：调用方法（getCountBySG:获取某个车系报名人数；getMCountBySG：获取某个车系下所有车型的报名人数）【必填】 sgId：车系id【必填】 callback：回调函数 返回结果 getCountBySG [{"result":true,"count":30971,"msg":"报名人数获取成功"}] getMCountBySG [ { "result":true, "count":[ { "modelId":12168, "count":3 }, { "modelId":11309, "count":3 }, { "modelId":11310, "count":3 }, { "modelId":12158, "count":3 }, { "modelId":27110, "count":3 } ], "msg":"报名人数获取成功" } ] }}} === 2.7 我的 === ==== 2.7.1. 我的-订阅列表 ==== 测试url : http://v12.pcauto.com.cn:8004/interface/app/get_autobuyApp.jsp 正式url : http://wxzs.pcauto.com.cn/interface/app/get_autobuyApp.jsp [[BR]]参数描述: [[BR]]@param callback 回调函数名,选填 [[BR]]@param m 调用的方法,必填，取值m=getFavorList : 获取我的爱车列表 [[BR]]@param dId 设备ID,必填 [[BR]]@param bt 报名-起始时间, 选填 格式为:yyyy-MM-dd 例:2014-08-11 [[BR]]@param et 报名-结束时间, 选填 格式为:yyyy-MM-dd 例:2014-08-11 [[BR]]@param page 分页,当前页数, 选填 [[BR]]@param size 分页,页面长度, 选填 [[BR]]json 例: {{{ {"models":"1,360,518","serialgroups":"3424,4254"} }}} ==== 2.7.2. 我的-添加车型/车系订阅 ==== 未上线 测试url : http://v12.pcauto.com.cn:8004/interface/app/do_autobuyApp.jsp 正式url : http://wxzs.pcauto.com.cn/interface/app/do_autobuyApp.jsp [[BR]]参数描述: {{{ @param callback 回调函数名,可选 @param m 调用的方法,必填，m的取值，{m=modelFavor,serialgroupFavor}，参数说明如下： 取值1，m=modelFavor : 车型 新增/取消 收藏 　 @param dId 设备ID,必填 　 @param mId 车型ID,必填 　 @param func 功能类型,必填,取值{add:新增收藏，cancle:取消收藏} 　　　　　 取值1，m=serialgroupFavor : 车系 新增/取消 收藏 　 @param dId 设备ID,必填 　 @param sgId 车系ID,必填 　 @param func 功能类型,必填，取值{add:新增收藏，cancle:取消收藏} }}}　　　　 ==== 2.7.3. 我的-团购列表 ==== [[BR]]未上线 [[BR]]测试url : http://v12.pcauto.com.cn:8004/interface/app/get_autobuyOrder.jsp [[BR]]正式url :http://wxzs.pcauto.com.cn/interface/app/get_autobuyOrder.jsp [[BR]]参数描述: [[BR]]@param callback 回调函数名,选填 [[BR]]@param m 调用的方法,必填，取值=getOrderList : 获取我的团购报名列表 [[BR]]@param dId 设备ID,必填 [[BR]]@param bt 报名-起始时间, 选填 格式为:yyyy-MM-dd 例:2014-08-11 [[BR]]@param et 报名-结束时间, 选填 格式为:yyyy-MM-dd 例:2014-08-11 [[BR]]@param page 分页,当前页数, 选填 [[BR]]@param size 分页,页面长度, 选填 {{{ @return json 例: {　 　"data": [ 　　{ 　　　"acId": 191, ##团购活动id 　　　"deadline": "2014-08-06", ##活动截至时间 　　　"discount": 0.20, ##优惠 　　　"discountPrice": 11.07, ##优惠价 　　　"image": " http://img.pconline.com.cn/images/upload/upc/tx/auto5/1406/25/c5/35654388_1403678285814_350x260.jpg", ##图像 　　　"orderCount": 3, ##报名人数 　　　"sgId": 8670, ##车系id 　　　"sgName": "奥迪Q3", ##车系名 　　　"title": "奥迪A4L 2013款 2.0 40TFSI quattro" ##活动标题 　　},{ 　　　...其他团购信息 　　}] } }}} ==== 2.7.4. 我的-陪购列表 ==== {{{ //1.0.0 本期不用做 }}} ==== 2.7.4. 我的-消息推送定制 ==== {{{ 未上线 测试url : http://v12.pcauto.com.cn:8004/interface/app/do_autobuyApp.jsp 正式url : http://wxzs.pcauto.com.cn/interface/app/do_autobuyApp.jsp 参数描述: @param callback 回调函数名,可选 @param m 调用的方法,必填，m的取值，{m= triggerSync}，参数说明如下： @param dId 设备ID,必填 @param push 开关值,必填 0:不推送, 1:推送 @param type 功能类型,必填，取值：1:推送总开关. 2:夜间推送开关. 3:团购推送开关. 4:优惠推送开关. }}} ==== 2.7.5. 我的-车库数据启动同步接口 ==== {{{ 测试url : http://v12.pcauto.com.cn:8004/interface/app/do_autobuyApp.jsp 正式url : http://wxzs.pcauto.com.cn/interface/app/do_autobuyApp.jsp 参数描述: @param callback 回调函数名,可选 @param m 调用的方法,必填,m=launchSync : 启动购车APP时同步: 　　　@param dId 设备ID,必填 　　　@param app app名称,必填 　　　@param mIds 车型收藏ids 英文","号相隔 , 必填.若无收藏可不传此参数.(DB会跟mIds的值完全同步) 　　　@param sgIds 车系收藏ids 英文","号相隔 , 必填.若无收藏可不传此参数.(DB会跟sgIds的值完全同步) 　　　@param token app标识,选填 　　　@param rId 用户所在城市id,选填 　　　@param rName 用户所在城市名称,选填 　　　@param pushSwitch 推送总开关,选填 0:不推送, 1:推送 　　　@param nightPushSwitch 夜间推送开关,选填 0:不推送, 1:推送 　　　@param groupbuySwitch 团购推送开关,选填 0:不推送, 1:推送 　　　@param discountSwitch 优惠推送开关,选填 0:不推送, 1:推送 }}} ==== 2.7.8 根据车系/车型获取行情接口==== {{{ 正式地址：（已上线） http://price.pcauto.com.cn/dealer/interface/app/model_news4fav_json.jsp 测试地址： http://v17.pcauto.com.cn:8002/dealer/interface/app/model_news4fav_json.jsp 请求参数： areaId 地区id sgIds 车系id串，逗号分隔多个 modelIds 车型id串，逗号分隔多个 date 日期，格式：yyyy-MM-dd callback js回调函数名称 返回值： { "sgNews":[ { "newsCreateTime":"2014-08-18 09:04:19.0", "newsUrl":"http://m.pcauto.com.cn/auto/market/30830-5319592.html", "newsId":"5319592", "newsName":"朗逸最高优惠0.5万 现车充足", "sgId":"3225" } …… ], "modelNews":[ { "newsCreateTime":"2014-08-18 09:04:19.0", "newsUrl":"http://m.pcauto.com.cn/auto/market/30830-5319592.html", "newsId":"5319592", "newsName":"朗逸最高优惠0.5万 现车充足", "modelId":"3225" } …… ] } }}} === 2.8 工具 === ==== 2.8.1. 购车计算器/车险计算器 ==== {{{ 备注：经与接口讨论，web端同事建议本地计算 }}} === 2.9 图集 === ==== 2.9.1. 车系/车型图片筛选条件（已有接口） ==== {{{ 请求URL:http://mrobot.pcauto.com.cn/v2/price/pictureConditions?serialId=3404 http://mrobot.pcauto.com.cn/v2/price/pictureConditions?modelId=26593 HTTP请求方式：get 是否需要登录：否 返回格式：json 缓存方式：无 缓存时间：1小时 请求参数：serialId： 车系id，必填 modelId： 车型id，可选，当modelId不为0时，返回参数的models字段为空数组 返回参数： { "models":[ { "id":123, "modelName":"" } ], "types":[ { "id":1, "typeName":"外观" } ], "colors":[ { "id":1, "colorName":"" } ] } 请求后端URL： http://price.pcauto.com.cn/interface/iphone/photo_choose_option.jsp }}} ==== 2.9.2. 车系/车型图片筛选查询（已有接口） ==== {{{ 请求URL: http://mrobot.pcauto.com.cn/v2/price/pictures?serialGroupId=3404&modelId=26593&colorId=16133&typeId=1 HTTP请求方式：get 是否需要登录：否 返回格式：json 缓存方式：无 缓存时间：1小时 请求参数： serialId：车系id modelId：车型id typeId：图片类型id colorId：颜色id pageNo：第几页 pageSize：每页显示多少条 返回参数： { "data": [ { "bigPath": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1308/08/c4/24272527_1375932203312_500.jpg", "smallPath": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1308/08/c4/24272527_1375932203312_120x90.jpg" }, { "bigPath": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1308/08/c4/24272527_1375932206296_500.jpg", "smallPath": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1308/08/c4/24272527_1375932206296_120x90.jpg" }, { "bigPath": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1308/08/c4/24272527_1375932209296_500.jpg", "smallPath": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1308/08/c4/24272527_1375932209296_120x90.jpg" }, { "bigPath": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1308/08/c4/24272527_1375932212468_500.jpg", "smallPath": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1308/08/c4/24272527_1375932212468_120x90.jpg" }, { "bigPath": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1308/08/c4/24272527_1375932215640_500.jpg", "smallPath": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1308/08/c4/24272527_1375932215640_120x90.jpg" }, { "bigPath": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1308/08/c4/24272527_1375932218718_500.jpg", "smallPath": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1308/08/c4/24272527_1375932218718_120x90.jpg" } ], "pageCount": 4, "pageNo": 1, "pageSize": 6, "total": 19 } 请求后端URL： http://price.pcauto.com.cn/interface/iphone/photo_page_list.jsp }}} ==== 2.9.3. 车系/车型 全部图片查询（不用开发，等待下一版本设计） ==== {{{ 请求URL: 待开发 HTTP请求方式：get 是否需要登录：否 返回格式：json 缓存方式：无 缓存时间：1小时 请求参数： serialId：车系id modelId：车型id 返回参数： { [ { "groupid":23,// 图片分类id "name":"外观", "total":1024, "pictures":[// 只返回6张 { "bigPath": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1308/08/c4/24272527_1375932218718_500.jpg", "smallPath": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1308/08/c4/24272527_1375932218718_120x90.jpg" }, { "bigPath": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1308/08/c4/24272527_1375932218718_500.jpg", "smallPath": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1308/08/c4/24272527_1375932218718_120x90.jpg" } ... ] }, ... ] } }}}