== 1、需求描述 == 产品原型 [[http://rdtrac.pc.com.cn/mobile/pototype/pcauto-price/ver1.0.0/v3/index.html | v3 ]] [[http://rdtrac.pc.com.cn/mobile/pototype/pcauto-price/ver1.0.0/v2/index.html | v2 ]] [[http://rdtrac.pc.com.cn/mobile/pototype/pcauto-price/ver1.0.0/v1/index.html | v1 ]] == 2、接口文档 == [[TOC]] === 2.0 辅助接口：获取当前用户的可团购车系列表 === 备注：搜索接口，搜索某品牌下的车系[[BR]] 请求URL： 待定 [[BR]] HTTP请求方式：get[[BR]] 是否需要登录：否[[BR]] 返回格式：json[[BR]] 缓存方式：无[[BR]] 缓存时间：无[[BR]] 请求参数 ||参数名||类型||必须||说明|| ||cityid||string||是||用户所在城市|| 返回参数 ||参数名||类型||必须||说明|| ||list||array||是||有团购数据车系结果列表|| || ||list项结构|| || ||参数名||类型||必须||说明|| || ||seriesid||number||是||车系id|| || ||name||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||是||分页结果列表|| || ||列表项数据格式说明|| || ||参数名||类型||必须||说明|| || ||seriesid||number||是||车系id|| || ||namel||number||是||车系名称|| || ||thumb||string||是||列表预览图|| || ||price||string||是||价格|| || ||type||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]] 返回格式：html页面[[BR]] 缓存方式：无[[BR]] 缓存时间：无[[BR]] 请求参数 ||参数名||类型||必须||说明|| ||seriesid||string||是||车系id|| ||cityid||string||是||用户所在城市|| ||返回参数|| ||参数名||类型||必须||说明|| ||-||-||-||-|| ||页面内协议说明|| ||参数名||类型||必须||说明|| ||-||-||-||-|| ==== 2.车系-优惠 ==== [请参考：2.3.1章节] ==== 3.车系-参配 ==== 备注：搜索接口，搜索某品牌下的车系[[BR]] 请求URL： 待定 [[BR]] HTTP请求方式：get[[BR]] 是否需要登录：否[[BR]] 返回格式：html页面[[BR]] 缓存方式：无[[BR]] 缓存时间：无[[BR]] 请求参数 ||参数名||类型||必须||说明|| ||seriesid||string||是||车系下所有车型id串串，通过逗号隔开，如：1，2，3|| ||页面内协议说明|| ||参数名||类型||必须||说明|| ||-||-||-||-|| ==== 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：每页显示多少条 }}} ==== 5.车系-资讯 ==== 备注：搜索接口，搜索某品牌下的车系[[BR]] 请求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.2 车型 === ==== 1)车型-综述 ==== 备注：搜索接口，搜索某品牌下的车系[[BR]] 请求URL： 待定 [[BR]] HTTP请求方式：get[[BR]] 是否需要登录：否[[BR]] 返回格式：html页面[[BR]] 缓存方式：无[[BR]] 缓存时间：无[[BR]] 请求参数 ||参数名||类型||必须||说明|| ||modelid||string||是||车系id|| ||返回参数|| ||参数名||类型||必须||说明|| ||-||-||-||-|| ||页面内协议说明|| ||参数名||类型||必须||说明|| ||-||-||-||-|| ==== 2)车型-参配 ==== 备注：搜索接口，搜索某品牌下的车系[[BR]] 请求URL： 待定 [[BR]] HTTP请求方式：get[[BR]] 是否需要登录：否[[BR]] 返回格式：html页面[[BR]] 缓存方式：无[[BR]] 缓存时间：无[[BR]] 请求参数 ||参数名||类型||必须||说明|| ||modelid||string||是||车系id|| ||返回参数|| ||参数名||类型||必须||说明|| ||-||-||-||-|| ||页面内协议说明|| ||参数名||类型||必须||说明|| ||-||-||-||-|| ==== 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取出） }}} ==== 4)车型-团购/陪购 ==== 备注：搜索接口，搜索某品牌下的车系[[BR]] 请求URL： 待定 [[BR]] HTTP请求方式：get[[BR]] 是否需要登录：否[[BR]] 返回格式：html页面[[BR]] 缓存方式：无[[BR]] 缓存时间：无[[BR]] 请求参数 ||参数名||类型||必须||说明|| ||modelid||string||是||车系id|| ||返回参数|| ||参数名||类型||必须||说明|| ||-||-||-||-|| ||页面内协议说明|| ||参数名||类型||必须||说明|| ||-||-||-||-|| ==== 5)车型-优惠详情 ==== 备注：搜索接口，搜索某品牌下的车系[[BR]] 请求URL： 待定 [[BR]] HTTP请求方式：get[[BR]] 是否需要登录：否[[BR]] 返回格式：html页面[[BR]] 缓存方式：无[[BR]] 缓存时间：无[[BR]] 请求参数 ||参数名||类型||必须||说明|| ||modelid||string||是||车系id|| ||返回参数|| ||参数名||类型||必须||说明|| ||-||-||-||-|| ||页面内协议说明|| ||参数名||类型||必须||说明|| ||-||-||-||-|| === 2.2 找车 === ==== 1) 筛选-精准选车条件 ==== 备注：找车动态赛选-条件获取 [[BR]] 请求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) 筛选-快速查找符合条件个数/列表==== 备注：筛选条件变后，自动获取符合筛选条件的车型个数 [[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.3 优惠 === ==== 1) 优惠-优惠列表 （需要修改/重做）==== 备注：搜索接口，搜索某品牌下的车系[[BR]] 请求URL：http://mrobot.pcauto.com.cn/v3/price/activityList/{areaId}?pageNo=1&pageSize=20 [[BR]] HTTP请求方式：get[[BR]] 是否需要登录：否[[BR]] 返回格式：json[[BR]] 缓存方式：无[[BR]] 缓存时间：无[[BR]] 请求参数 ||参数名||类型||必须||说明|| ||seriesid||string||否||筛选条件，如果全部车型，则为空，多个车系的情况，以，号隔开|| ||cityid||string||是||用户所在地|| ||page||number||是||请求分页|| ||pagesize||number||是||请求分页大小|| 返回参数 ||参数名||类型||必须||说明|| ||total ||number||是||优惠总个数|| ||lista||array||是||分页数据列表|| || ||list列表项格式|| || ||参数名||类型||必须||说明|| || ||modelid||-||是||车型id|| || ||name||string||是||车型名称|| || ||price||number||是||原价|| || ||offprice||number||是||优惠价|| || ||shops||array||是||经销商|| || ||shops列表项格式|| || || ||参数名||类型||必须||说明|| || || ||shopid||-||是||经销商id|| || || ||name||number||是||车型id|| || || ||city||string||是||所在城市|| || || ||price||number||是||原价|| || || ||offprice||number||是||优惠价|| || || ||telephone||string||是||电话号码|| || || ||telephone||string||是||电话号码|| || || ||flag||number||是||是否4s店|| === 2.4 团购 === ==== 1) 团购-团购列表(含筛选) ==== 备注：搜索接口，搜索某品牌下的车系[[BR]] 请求URL： 待定 [[BR]] HTTP请求方式：get[[BR]] 是否需要登录：否[[BR]] 返回格式：json[[BR]] 缓存方式：无[[BR]] 缓存时间：无[[BR]] 请求参数 ||参数名||类型||必须||说明|| ||seriesid||string||否||筛选条件，如果全部车型，则为空，多个车系的情况，以，号隔开|| ||cityid||string||是||用户所在地|| ||page||number||是||请求分页|| ||pagesize||number||是||请求分页大小|| ||返回参数|| ||参数名||类型||必须||说明|| ||total||number||是||数据总个数|| ||list||array||是||分页结果列表|| || ||列表项格式|| || ||参数名||类型||必须||说明|| || ||seriesid||number||是||车系id|| || ||namel||number||是||车系活动名|| || ||thumb||string||是||车系预览图|| || ||price||string||是||显示价格|| || ||offvalue||string||是||优惠价格|| || ||enddate||string||是||结束时间|| || ||signupcount||string||是||报名人数|| ==== 2) 团购-在线报名 ==== 备注：搜索接口，搜索某品牌下的车系[[BR]] 请求URL： 待定 [[BR]] HTTP请求方式：get[[BR]] 是否需要登录：否[[BR]] 返回格式：html页面[[BR]] 缓存方式：无[[BR]] 缓存时间：无[[BR]] 请求参数 ||参数名||类型||必须||说明|| ||modelid||string||是||车系id|| ||返回参数|| ||参数名||类型||必须||说明|| ||-||-||-||-|| ||页面内协议说明|| ||参数名||类型||必须||说明|| ||-||-||-||-|| ==== 3) 团购-活动详细- ==== 备注：搜索接口，搜索某品牌下的车系[[BR]] 请求URL： 待定 [[BR]] HTTP请求方式：get[[BR]] 是否需要登录：否[[BR]] 返回格式：html页面[[BR]] 缓存方式：无[[BR]] 缓存时间：无[[BR]] 请求参数 ||参数名||类型||必须||说明|| ||modelid||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]] 请求参数 ||参数名||类型||必须||说明|| ||modelid||string||是||车型id,需要想要购买的车型的id|| ||price||string||是||裸车价，单位元|| ||type||number||是||1、全款购车 2、贷款购车 3、车险计算|| ||downpayment||string||否||首付款，非贷款购车时为空|| ||years||number||否||还款年限，非贷款购车时为空|| ||返回参数|| ||参数名||类型||必须||说明|| ||must||object||是||必要花费|| ||insurance||object||是||商业保险花费|| must结构说明 {{{ { [ { "feename":"购置税", "pay":"99", "options":[ { "name":"家用6座以上", "value":"101", }, ] } ] } }}} insurance结构说明 {{{ { [ { "keyid":1, "name":"购置税", "fee":{ // 费用有4个值：分别对应：高性价、经济适用、全面保障、自定义 "height":100， "economy":50， "all":120， "custom":80 }, "options":[ { "name":"家用6座以上", "value":"101", "effectItems":[//自定义的情况下，选了该值之后，相关联的保险数额需要变动数组 { "keyid":456, "value":123, }， .... ] }, ] } ] } }}} === 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 }}} ==== 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" } ... ] }, ... ] } }}}