== 接口文档 == [[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]]请求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]]请求URL：http://dev3.pcauto.com.cn:8001/interface/iphone/serialGroup_list_v2.jsp?bid=1&type=1 [[BR]] HTTP请求方式：get [[BR]] 是否需要登录：否 [[BR]] 返回格式：json [[BR]] 缓存方式：无 [[BR]] 缓存时间：5分钟 [[BR]] 请求参数： ||bid||number||品牌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.车型库-热销排行榜 ==== 备注： [[BR]]请求URL： http://dev3.pcauto.com.cn:8001/interface/iphone/praiselist_by_kindId.jsp?kindId=1&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]]请求URL：http://mrobot.pcauto.com.cn/v3/price/modelsForSearch [[BR]]请求后端URL：http://www.pcauto.com.cn/client/news/tghd/1401/intf2907.js [[BR]]HTTP请求方式：get [[BR]]是否需要登录：否 [[BR]]返回格式：json [[BR]]缓存方式：无 [[BR]]缓存时间：无 [[BR]]请求参数：无 [[BR]]返回参数： {{{ { "modelList": [{ "id": 123, "name": "蒙迪欧" }] } }}} ==== 2.1.5 车型库-车系搜索 ==== 备注： [[BR]]请求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||查询条件|| ||pageNo||页码|| ||pageSize||一页条数|| === 2.2 车系 === ==== 2.2.1.车系-综述 ==== 备注： 请求URL： 待定 [[BR]] HTTP请求方式：get[[BR]] 是否需要登录：否[[BR]] 返回格式：html页面[[BR]] 缓存方式：无[[BR]] 缓存时间：无[[BR]] 请求参数 ||参数名||类型||必须||说明|| ||seriesid||string||是||车系id|| ||areaId||string||是||用户所在城市|| ||返回参数|| ||参数名||类型||必须||说明|| ||-||-||-||-|| ||页面内协议说明|| ||参数名||类型||必须||说明|| ||-||-||-||-|| ==== 2.2.2.车系-优惠 ==== [请参考：2.3.1章节] ==== 2.2.3.车系-参配 ==== 备注： 请求URL： 待定 [[BR]] HTTP请求方式：get[[BR]] 是否需要登录：否[[BR]] 返回格式：html页面[[BR]] 缓存方式：无[[BR]] 缓存时间：无[[BR]] 请求参数 ||参数名||类型||必须||说明|| ||seriesid||string||是||车系下所有车型id串串，通过逗号隔开，如：1，2，3|| ||页面内协议说明|| ||参数名||类型||必须||说明|| ||-||-||-||-|| ==== 2.2.4.车系-点评（资讯客户端的车主点评列表） ==== {{{ 备注：获取某车系下的车主点评列表。接口为网页，点击网页中列表，跳转协议为：pcaction://pcauto-owner-review?modelId=${id} 请求URL：http://mrobot.pcauto.com.cn/v3/price/commentList/{serialId} HTTP请求方式：get 是否需要登录：否 返回格式：html页面 缓存方式：无 缓存时间：无 请求参数： serialId：车系id night：晚间模式（传值时，传日间模式) 请求后端URL： http://price.pcauto.com.cn/interface/iphone/commentList_by_sgid.jsp?sid=3404&pageNo=1&pageSize=10 请求后端参数： sid：车系id（从id_0中取出） pageNo：第几页 pageSize：每页显示多少条 }}} ==== 2.2.5.车系-资讯 ==== 备注：（（现有接口，每个tab，请求不同的url，之所以弄出来，是想做个整合后的）） 请求URL： 待定 [[BR]] HTTP请求方式：get[[BR]] 是否需要登录：否[[BR]] 返回格式：json[[BR]] 缓存方式：无[[BR]] 缓存时间：无[[BR]] 请求参数 ||参数名||类型||必须||说明|| ||seriesid||string||是||车系id|| ||page||number||是||分页页码|| ||pagesize||number||是||分页大小|| ||infotype||number||是||资讯类型：0、全部、1、新闻 2、评测 3、导购 4、行情|| ||返回参数|| ||参数名||类型||必须||说明|| ||total||number||yes||资讯总个数|| ||list||array||yes||资讯列表分页数据|| || ||列表项格式|| || ||参数名||类型||必须||说明|| || ||infoid||string||是||文章id|| || ||thumb||string||是||文章缩略图|| || ||title||string||是||文章标题|| || ||type||string||是||文章类型|| || ||date||string||是||文章时间|| === 2.3 车型 === ==== 2.3.1.车型-综述 ==== 备注： 请求URL： 待定 [[BR]] HTTP请求方式：get[[BR]] 是否需要登录：否[[BR]] 返回格式：html页面[[BR]] 缓存方式：无[[BR]] 缓存时间：无[[BR]] 请求参数 ||参数名||类型||必须||说明|| ||modelid||string||是||车系id|| ||返回参数|| ||参数名||类型||必须||说明|| ||-||-||-||-|| ||页面内协议说明|| ||参数名||类型||必须||说明|| ||-||-||-||-|| ==== 2.3.2.车型-参配 ==== 备注： 请求URL： 待定 [[BR]] HTTP请求方式：get[[BR]] 是否需要登录：否[[BR]] 返回格式：html页面[[BR]] 缓存方式：无[[BR]] 缓存时间：无[[BR]] 请求参数 ||参数名||类型||必须||说明|| ||modelid||string||是||车系id|| ||返回参数|| ||参数名||类型||必须||说明|| ||-||-||-||-|| ||页面内协议说明|| ||参数名||类型||必须||说明|| ||-||-||-||-|| ==== 2.3.3.车型-点评（资讯客户端的车主点评） ==== {{{ 备注：车主点评终端页 请求URL：http://mrobot.pcauto.com.cn/v3/price/commentDetail/{modelId} v4.3之后请使用如下url： http://mrobot.pcauto.com.cn/v3/price/commentDetail/{modelId}?userId=123&isShow=0 HTTP请求方式：get 是否需要登录：否 返回格式：html页面 缓存方式：无 缓存时间：无 请求参数： 车型id userId： 用户id isShow：0，不显示车型名称；1，显示车型名称 阅读模式：无参数 白天；night 晚间（传值时，传日间模式) 请求后端URL： http://price.pcauto.com.cn/interface/iphone/detail_comment_owner.jsp?mid=19799 http://price.pcauto.com.cn/interface/iphone/model_detail.jsp?mid=19799 http://price.pcauto.com.cn/interface/iphone/model_list_v3.jsp //其他车型 请求后端参数： mid：车型id（从id_0取出） }}} ==== 2.3.4.车型-团购/陪购 ==== 备注： 请求URL： 待定 [[BR]] HTTP请求方式：get[[BR]] 是否需要登录：否[[BR]] 返回格式：html页面[[BR]] 缓存方式：无[[BR]] 缓存时间：无[[BR]] 请求参数 ||参数名||类型||必须||说明|| ||modelid||string||是||车系id|| ||返回参数|| ||参数名||类型||必须||说明|| ||-||-||-||-|| ||页面内协议说明|| ||参数名||类型||必须||说明|| ||-||-||-||-|| ==== 2.3.5.车型-优惠详情 ==== 备注： 请求URL： 待定 [[BR]] HTTP请求方式：get[[BR]] 是否需要登录：否[[BR]] 返回格式：html页面[[BR]] 缓存方式：无[[BR]] 缓存时间：无[[BR]] 请求参数 ||参数名||类型||必须||说明|| ||modelid||string||是||车系id|| ||返回参数|| ||参数名||类型||必须||说明|| ||-||-||-||-|| ||页面内协议说明|| ||参数名||类型||必须||说明|| ||-||-||-||-|| === 2.4 找车 === ==== 2.4.1. 筛选-精准选车条件 ==== 备注： 请求URL： 待定 ，（可参考资讯客户端：http://mrobot.pcauto.com.cn/v3/price/models/criterionv36?v=4.0.0）[[BR]] HTTP请求方式：get[[BR]] 是否需要登录：否[[BR]] 返回格式：json[[BR]] 缓存方式：无[[BR]] 缓存时间：无[[BR]] 请求参数：无[[BR]] 返回参数： {{{ { "criterion": [ { "name":"价格", "value":"cluster_price" "cris": [ { "count": "", "name": "SUB", "value": "0", "options":[ // 附加可选值，区别于资讯客户端的数据 { "name": "全部SUV", "value": "1", },{ "name": "小型SUV", "value": "1", }.... ] }.... ] }, { "name":"排量", "value":"cluster_std_displacement" "cris": [ { "count": "", "name": "1.0L以下", "value": "0", "options":[ ] }.... ] }... } }}} ==== 2.4.2. 筛选-快速查找符合条件个数/列表==== 备注：筛选条件变后，自动获取符合筛选条件的车型个数 [[BR]] 请求URL： 待定 ,可参考：http://trac.pc.com.cn/iphone/wiki/intfs_new#a2.8.3精准选车条件 [[BR]] HTTP请求方式：get[[BR]] 是否需要登录：否[[BR]] 返回格式：json[[BR]] 缓存方式：无[[BR]] 缓存时间：无[[BR]] 请求参数 ||参数名||类型||必须||说明|| ||qryfor||number||是||1、请求个数，2、请求列表|| ||page||number||否||请求分页页码，qryfor=1时，可不传|| ||pagesize||number||否||请求分页大小，qryfor=1时，可不传|| ||queryJson||string||是||动态组合的json数据，根据筛选条件组装|| {{{ queryJson={[ {"key":"cluster_std_displacement", "value":"0", }, {"key":"cluster_std_displacement", "value":"0", }, ..... ]} }}} 返回参数 ||参数名||类型||必须||说明|| ||total ||number||是||符合筛选条件的车系总个数|| ||list||array||否||qryfor=1时，可不传|| || ||list列表项格式|| || ||参数名||类型||必须||说明|| || ||seriesid||-||是||车系id|| || ||name||number||是||车型名称|| === 2.5 优惠 === ==== 2.5.1. 优惠-优惠列表 ==== 正式环境URL：[[BR]] 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_group_model_json.jsp [[BR]] HTTP请求方式：get [[BR]] 返回格式：json [[BR]] 请求参数 [[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.6 团购 === ==== 2.6.1. 团购-团购列表(含筛选) ==== 备注： 请求URL： 正式环境URL：[[BR]] http://mai.pcauto.com.cn/gct/interface/get_gct_activity_list.jsp?regionId=1[[BR]] 测试环境URL：[[BR]] http://dev3.pcauto.com.cn:9977/gouchetuan/interface/get_gct_activity_list.jsp?regionId=1[[BR]] HTTP请求方式：get[[BR]] 是否需要登录：否[[BR]] 返回格式：json[[BR]] 缓存方式：无[[BR]] 缓存时间：无[[BR]] 请求参数 ||参数名||类型||必须||说明|| ||seriesid||string||否||筛选条件，如果全部车型，则为空，多个车系的情况，以，号隔开|| ||regionId||string||是||城市id|| ||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. 团购-活动详细- ==== {{{ 正式环境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 HTTP请求方式：get 返回格式：json 请求参数 tsgId：团购活动id 返回参数 { "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. 团购报名接口信息 ==== {{{ 正式环境URL：（注：正式环境的报名数据会派发给经销商，测试开发过程慎用） http://mai.pcauto.com.cn/gct/action/do_order.jsp?req-enc=utf-8 测试环境URL： http://dev3.pcauto.com.cn:9977/gouchetuan/action/do_order.jsp?req-enc=utf-8 HTTP请求方式：post 返回格式：json 请求参数 modelId：车型id【必填】 userName：报名人名称【必填】 phone：报名人电话【必填】 dealerId：经销商id【必填】 tsgId：团购活动id【必填】 regionId：城市id【必填】 provinceId：省份id【必填】 origin：平台来源,0:未知,1:web,2:wap,3:IOS,4:Android,5:WP,6:杂志【必填】 referer：来源URL（当前页面的url）【选填】 返回参数 { code:200 //报名成功 } 204 - 表单必填参数不完整 205 - 活动结束，不能报名 206 - 活动未审核，不能报名 207 - 活动审核失败，不能报名 500 - 系统错误 }}} === 2.7 我的 === ==== 2.7.1. 我的-订阅列表 ==== {{{ 本地保存的数据-无接口 }}} ==== 2.7.2. 我的-团购列表 ==== {{{ 本地保存的数据-无接口 }}} ==== 2.7.3. 我的-陪购列表 ==== {{{ 本地保存的数据-无接口 }}} ==== 2.7.4. 我的-消息推送定制 ==== 备注： 请求URL： 待定 [[BR]] HTTP请求方式：get[[BR]] 是否需要登录：否[[BR]] 返回格式：json[[BR]] 缓存方式：无[[BR]] 缓存时间：无[[BR]] 请求参数 ||参数名||类型||必须||说明|| ||devicestoken||string||是||设备push消息对应的token值|| ||switch||bool||是||是否接收push消息|| ||distubmode||bool||是||夜间勿扰模式|| ||channels||string||否||团购、陪购、优惠的内容定制，定制：1，不定制：0，如3个都定制的情况，传:1,1,1，只定制团购，其他不定制，传：1,0,0|| ||返回参数|| ||参数名||类型||必须||说明|| ||code||number||是||消息定制结果码，0：成功，其他失败|| ||msg||string||是||错误的情况下的，错误信息|| === 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" } ... ] }, ... ] } }}}