== 1、需求描述 == == 2、接口文档 == === 2.0 辅助接口：获取当前用户的可团购车系列表 === 备注：搜索接口，搜索某品牌下的车系[[BR]] 请求URL： 待定 [[BR]] HTTP请求方式：get[[BR]] 是否需要登录：否[[BR]] 返回格式：json[[BR]] 缓存方式：无[[BR]] 缓存时间：无[[BR]] 请求参数 ||参数名||类型||必须||说明|| ||city||string||是||用户所在城市|| 返回参数 ||参数名||类型||必须||说明|| ||list||array||是||有团购数据车系结果列表|| || ||list项结构|| || ||参数名||类型||必须||说明|| || ||sid||number||是||车系id|| || ||namel||string||是||车系名|| === 2.1 车型库 === ==== 1.车型库-品牌列表（已有接口）==== {{{ 备注：获取车型库品牌列表 请求URL：http://mrobot.pcauto.com.cn/v2/price/brands HTTP请求方式：get 是否需要登录：否 返回格式：json 缓存方式：无 缓存时间：1天 请求参数：无 请求后端URL： http://price.pcauto.com.cn/interface/iphone/brand_list.jsp }}} ==== 2.热门车系列表（已有接口）==== {{{ 备注:1、车型库首页热门车系； 2、获取可能感兴趣内容 请求URL:http://mrobot.pcauto.com.cn/configs/pcauto_hot_serials HTTP请求方式：get 是否需要登录：是 返回格式：json 缓存方式：无 缓存时间：无 请求参数：无 }}} ==== 3.车型库-品牌-车系列表 （已有接口，但需要修改）==== 备注：通过品牌ID得到车系列表 [[BR]]请求URL：http://mrobot.pcauto.com.cn/v3/price/getSerialListByBrandId/60 [[BR]] HTTP请求方式：get [[BR]] 是否需要登录：否 [[BR]] 返回格式：json [[BR]] 缓存方式：无 [[BR]] 缓存时间：5分钟 请求参数： ||id||number||品牌id 求后端URL：http://price.pcauto.com.cn/interface/iphone/serialGroup_list_v2.jsp?bid=60 [[BR]]请求后端参数： ||id||number||品牌id 返回参数，需要增加一个字段： ||'''参数名'''||'''类型'''||'''必须'''||'''说明'''|| || salestatus||number||必须||1、在售、2停售|| ==== 3.车型库-热销排行榜 ==== 备注：搜索接口，搜索某品牌下的车系[[BR]] 请求URL： 待定 [[BR]] HTTP请求方式：get[[BR]] 是否需要登录：否[[BR]] 返回格式：json[[BR]] 缓存方式：无[[BR]] 缓存时间：无[[BR]] 请求参数 ||参数名||类型||必须||说明|| ||type||number||是||1~7分别代表：微型、小型车、紧凑车型，中型车、中大型车|| ||page||number||是||请求分页|| ||pagesize||number||是||请求分页大小|| ||返回参数|| ||参数名||类型||必须||说明|| ||total||number||是||数据总个数|| ||list||array||是||分页结果列表|| || ||列表项数据格式说明|| || ||参数名||类型||必须||说明|| || ||cid||number||是||数据总个数|| || ||namel||number||是||数据总个数|| || ||thumb||string||是||文章缩略图|| || ||price||string||是||数据总个数|| || ||type||string||是||车型分类|| || ||activities||string||是||是否有团购活动|| ==== 5.车型库-搜索-关键词 ==== 备注：动态获取搜索关键字，由编辑在cms里维护[[BR]] 请求URL：http://mrobot.pcauto.com.cn/v3/price/modelsForSearch [[BR]] HTTP请求方式：get[[BR]] 是否需要登录：否[[BR]] 返回格式：json[[BR]] 缓存方式：无[[BR]] 缓存时间：无[[BR]] 请求参数：无[[BR]] 返回参数： {{{ { "modelList": [{ "id": 123, "name": "蒙迪欧" }] } }}} 请求后端URL：http://www.pcauto.com.cn/client/news/tghd/1401/intf2907.js ==== 6. 车型库-车系搜索 ==== 备注：搜索接口，搜索某品牌下的车系[[BR]] 请求URL：http://mrobot.pcauto.com.cn/v3/price/models/search?keyword=大众&pageNo=1&pageSize=1000 [[BR]] HTTP请求方式：get[[BR]] 是否需要登录：否[[BR]] 返回格式：json[[BR]] 缓存方式：无[[BR]] 缓存时间：无[[BR]] 请求参数: ||keyword||查询条件|| ||pageNo||页码|| ||pageSize||一页条数|| 请求后端URL：http://price.pcauto.com.cn/interface/iphone/search_serial_group_list.jsp?pageNo=1&pageSize=1000&keyword=大众 [[BR]] 请求后端参数: ||keyword||查询条件|| ||pageNo||页码|| ||pageSize||一页条数|| === 2.1 车系 === ==== 1.车系-综述 ===== 备注：搜索接口，搜索某品牌下的车系[[BR]] 请求URL： 待定 [[BR]] HTTP请求方式：get[[BR]] 是否需要登录：否[[BR]] 返回格式：json[[BR]] 缓存方式：无[[BR]] 缓存时间：无[[BR]] 请求参数 ||参数名||类型||必须||说明|| ||seriesid||string||是||车系id|| ||city||string||是||用户所在城市|| ||返回参数|| ||参数名||类型||必须||说明|| ||-||-||-||-|| ||页面内协议说明|| ||参数名||类型||必须||说明|| ||-||-||-||-|| ==== 2.车系-优惠 ==== 备注：搜索接口，搜索某品牌下的车系[[BR]] 请求URL： 待定 [[BR]] HTTP请求方式：get[[BR]] 是否需要登录：否[[BR]] 返回格式：json[[BR]] 缓存方式：无[[BR]] 缓存时间：无[[BR]] 请求参数 ||参数名||类型||必须||说明|| ||seriesid||string||是||车系id|| ||city||string||是||用户所在城市|| ||返回参数|| ||参数名||类型||必须||说明|| ||total||number||yes||优惠总个数|| ||list||array||yes||优惠数据列表|| || ||list列表项格式|| || ||参数名||类型||必须||说明|| || ||cid||-||是||车型id|| || ||cname||number||是||车型id|| || ||cname||string||是||车型名称|| || ||price||number||是||原价|| || ||offprice||number||是||优惠价|| || ||shops||array||是||经销商|| || ||shops列表项格式|| || || ||参数名||类型||必须||说明|| || || ||sid||-||是||经销商id|| || || ||name||number||是||车型id|| || || ||city||string||是||所在城市|| || || ||price||number||是||原价|| || || ||offprice||number||是||优惠价|| || || ||telephone||string||是||电话号码|| || || ||telephone||string||是||电话号码|| || || ||flag||number||是||是否4s店|| ==== 3.车系-参配 ==== 备注：搜索接口，搜索某品牌下的车系[[BR]] 请求URL： 待定 [[BR]] HTTP请求方式：get[[BR]] 是否需要登录：否[[BR]] 返回格式：json[[BR]] 缓存方式：无[[BR]] 缓存时间：无[[BR]] 请求参数 ||参数名||类型||必须||说明|| ||seriesid||string||是||车系id|| ||返回参数|| ||参数名||类型||必须||说明|| ||total||number||yes||优惠总个数|| ||list||array||yes||优惠数据列表|| ||列表项数据格式说明|| ||参数名||类型||必须||说明|| ||待定||-||是||-|| ==== 4.车系-点评 ==== 备注：搜索接口，搜索某品牌下的车系[[BR]] 请求URL： 待定 [[BR]] HTTP请求方式：get[[BR]] 是否需要登录：否[[BR]] 返回格式：json[[BR]] 缓存方式：无[[BR]] 缓存时间：无[[BR]] 请求参数 ||参数名||类型||必须||说明|| ||seriesid||string||是||车系id|| ||返回参数|| ||参数名||类型||必须||说明|| ||-||-||-||-|| ||页面内协议说明|| ||参数名||类型||必须||说明|| ||-||-||-||-|| ==== 5.车系-资讯 ==== 备注：搜索接口，搜索某品牌下的车系[[BR]] 请求URL： 待定 [[BR]] HTTP请求方式：get[[BR]] 是否需要登录：否[[BR]] 返回格式：json[[BR]] 缓存方式：无[[BR]] 缓存时间：无[[BR]] 请求参数 ||参数名||类型||必须||说明|| ||seriesid||string||是||车系id|| ||page||number||是||分页页码|| ||pagesize||number||是||分页大小|| ||infotype||number||是||资讯类型：0、全部、1、报价、3、其他（待定）|| ||返回参数|| ||参数名||类型||必须||说明|| ||total||number||yes||资讯总个数|| ||list||array||yes||资讯列表分页数据|| || ||列表项格式|| || ||参数名||类型||必须||说明|| || ||thumb||string||是||文章缩略图|| || ||title||string||是||文章标题|| || ||type||string||是||文章类型|| || ||date||string||是||文章时间|| === 2.2 车型 === ==== 1)车型-综述 ==== 备注：搜索接口，搜索某品牌下的车系[[BR]] 请求URL： 待定 [[BR]] HTTP请求方式：get[[BR]] 是否需要登录：否[[BR]] 返回格式：json[[BR]] 缓存方式：无[[BR]] 缓存时间：无[[BR]] 请求参数 ||参数名||类型||必须||说明|| ||carid||string||是||车系id|| ||返回参数|| ||参数名||类型||必须||说明|| ||-||-||-||-|| ||页面内协议说明|| ||参数名||类型||必须||说明|| ||-||-||-||-|| ==== 2)车型-参配 ==== 备注：搜索接口，搜索某品牌下的车系[[BR]] 请求URL： 待定 [[BR]] HTTP请求方式：get[[BR]] 是否需要登录：否[[BR]] 返回格式：json[[BR]] 缓存方式：无[[BR]] 缓存时间：无[[BR]] 请求参数 ||参数名||类型||必须||说明|| ||carid||string||是||车系id|| ||返回参数|| ||参数名||类型||必须||说明|| ||-||-||-||-|| ||页面内协议说明|| ||参数名||类型||必须||说明|| ||-||-||-||-|| ==== 3)车型-点评 ==== 备注：搜索接口，搜索某品牌下的车系[[BR]] 请求URL： 待定 [[BR]] HTTP请求方式：get[[BR]] 是否需要登录：否[[BR]] 返回格式：json[[BR]] 缓存方式：无[[BR]] 缓存时间：无[[BR]] 请求参数 ||参数名||类型||必须||说明|| ||carid||string||是||车系id|| ||返回参数|| ||参数名||类型||必须||说明|| ||-||-||-||-|| ||页面内协议说明|| ||参数名||类型||必须||说明|| ||-||-||-||-|| ==== 4)车型-团购/陪购 ==== 备注：搜索接口，搜索某品牌下的车系[[BR]] 请求URL： 待定 [[BR]] HTTP请求方式：get[[BR]] 是否需要登录：否[[BR]] 返回格式：json[[BR]] 缓存方式：无[[BR]] 缓存时间：无[[BR]] 请求参数 ||参数名||类型||必须||说明|| ||carid||string||是||车系id|| ||返回参数|| ||参数名||类型||必须||说明|| ||-||-||-||-|| ||页面内协议说明|| ||参数名||类型||必须||说明|| ||-||-||-||-|| ==== 5)车型-优惠详情 ==== 备注：搜索接口，搜索某品牌下的车系[[BR]] 请求URL： 待定 [[BR]] HTTP请求方式：get[[BR]] 是否需要登录：否[[BR]] 返回格式：json[[BR]] 缓存方式：无[[BR]] 缓存时间：无[[BR]] 请求参数 ||参数名||类型||必须||说明|| ||carid||string||是||车系id|| ||返回参数|| ||参数名||类型||必须||说明|| ||-||-||-||-|| ||页面内协议说明|| ||参数名||类型||必须||说明|| ||-||-||-||-|| === 2.2 找车 === ==== 1) 筛选-快速查找符合条件个数 ==== 备注：搜索接口，搜索某品牌下的车系[[BR]] 请求URL： 待定 [[BR]] HTTP请求方式：get[[BR]] 是否需要登录：否[[BR]] 返回格式：json[[BR]] 缓存方式：无[[BR]] 缓存时间：无[[BR]] 请求参数 ==== 2) 筛选-符合条件列表 ==== 备注：搜索接口，搜索某品牌下的车系[[BR]] 请求URL： 待定 [[BR]] HTTP请求方式：get[[BR]] 是否需要登录：否[[BR]] 返回格式：json[[BR]] 缓存方式：无[[BR]] 缓存时间：无[[BR]] 请求参数 === 2.3 优惠 === ==== 1) 优惠-优惠列表 ==== 备注：搜索接口，搜索某品牌下的车系[[BR]] 请求URL： 待定 [[BR]] HTTP请求方式：get[[BR]] 是否需要登录：否[[BR]] 返回格式：json[[BR]] 缓存方式：无[[BR]] 缓存时间：无[[BR]] 请求参数 === 2.4 团购 === ==== 1) 团购-团购列表(含筛选) ==== 备注：搜索接口，搜索某品牌下的车系[[BR]] 请求URL： 待定 [[BR]] HTTP请求方式：get[[BR]] 是否需要登录：否[[BR]] 返回格式：json[[BR]] 缓存方式：无[[BR]] 缓存时间：无[[BR]] 请求参数 ||参数名||类型||必须||说明|| ||seriesid||string||否||筛选条件，如果全部车型，则为空，多个车系的情况，以，号隔开|| ||city||string||是||用户所在地|| ||page||number||是||请求分页|| ||pagesize||number||是||请求分页大小|| ||返回参数|| ||参数名||类型||必须||说明|| ||total||number||是||数据总个数|| ||list||array||是||分页结果列表|| || ||列表项格式|| || ||参数名||类型||必须||说明|| || ||sid||number||是||车系id|| || ||namel||number||是||车系活动名|| || ||thumb||string||是||车系预览图|| || ||price||string||是||显示价格|| || ||offvalue||string||是||优惠价格|| || ||enddate||string||是||结束时间|| || ||signupcount||string||是||报名人数|| ==== 2) 团购-在线报名 ==== 备注：搜索接口，搜索某品牌下的车系[[BR]] 请求URL： 待定 [[BR]] HTTP请求方式：get[[BR]] 是否需要登录：否[[BR]] 返回格式：json[[BR]] 缓存方式：无[[BR]] 缓存时间：无[[BR]] 请求参数 ||参数名||类型||必须||说明|| ||carid||string||是||车系id|| ||返回参数|| ||参数名||类型||必须||说明|| ||-||-||-||-|| ||页面内协议说明|| ||参数名||类型||必须||说明|| ||-||-||-||-|| ==== 3) 团购-活动详细- ==== 备注：搜索接口，搜索某品牌下的车系[[BR]] 请求URL： 待定 [[BR]] HTTP请求方式：get[[BR]] 是否需要登录：否[[BR]] 返回格式：json[[BR]] 缓存方式：无[[BR]] 缓存时间：无[[BR]] 请求参数 ||参数名||类型||必须||说明|| ||carid||string||是||车系id|| ||返回参数|| ||参数名||类型||必须||说明|| ||-||-||-||-|| ||页面内协议说明|| ||参数名||类型||必须||说明|| ||-||-||-||-|| === 2.5 我的 === ==== 1) 我的-订阅列表 ==== {{{ 本地保存的数据-无接口 }}} ==== 2) 我的-团购列表 ==== {{{ 本地保存的数据-无接口 }}} ==== 3) 我的-陪购列表 ==== {{{ 本地保存的数据-无接口 }}} ==== 4) 我的-消息推送定制 ==== 备注：搜索接口，搜索某品牌下的车系[[BR]] 请求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.6 工具 === ==== 1) 购车计算器 ==== 备注：搜索接口，搜索某品牌下的车系[[BR]] 请求URL： 待定 [[BR]] HTTP请求方式：get[[BR]] 是否需要登录：否[[BR]] 返回格式：json[[BR]] 缓存方式：无[[BR]] 缓存时间：无[[BR]] 请求参数 ||参数名||类型||必须||说明|| ||autoid||string||是||车型id,需要想要购买的车型的id|| ||price||string||是||裸车价，单位元|| ||ifloan ||bool||是||是否贷款购车|| ||downpayment||string||否||首付款，非贷款购车时为空|| ||years||number||否||还款年限，非贷款购车时为空|| ||返回参数|| ||参数名||类型||必须||说明|| ||url||string||是||计算结果web页面地址|| ==== 2) 车险计算器 ==== 备注：搜索接口，搜索某品牌下的车系[[BR]] 请求URL： 待定 [[BR]] HTTP请求方式：get[[BR]] 是否需要登录：否[[BR]] 返回格式：json[[BR]] 缓存方式：无[[BR]] 缓存时间：无[[BR]] 请求参数 ||参数名||类型||必须||说明|| ||autoid||string||是||车型id,车险对应的车型的id|| ||price||string||是||裸车价，单位元|| ||返回参数|| ||参数名||类型||必须||说明|| ||url||string||是||计算结果web页面地址|| ==== 3) 车型对比器 ==== 备注：搜索接口，搜索某品牌下的车系[[BR]] 请求URL： 待定 [[BR]] HTTP请求方式：get[[BR]] 是否需要登录：否[[BR]] 返回格式：json[[BR]] 缓存方式：无[[BR]] 缓存时间：无[[BR]] 请求参数 ||参数名||类型||必须||说明|| ||-||string||是||-|| ||-||string||是||-|| ||返回参数|| ||参数名||类型||必须||说明|| ||url||string||是||计算结果web页面地址|| === 2.6 图集 （需要修改）=== ==== 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) 车系/车型图片筛选查询 ==== {{{ 请求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 }}}