1、需求描述
2、接口文档
2.0 辅助接口:获取当前用户的可团购车系列表
| 请求地址 | 待定
|
| method | get
|
| login | 否
|
| 返回格式 | json
|
| 缓存方式
|
| 缓存时间
|
| 请求参数
|
| 参数名 | 类型 | 必须 | 说明
|
| 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.车型库-车系-车型列表
| URL | 待定
|
| method | get
|
| login | 否
|
| 返回格式 | json
|
| 缓存方式
|
| 缓存时间
|
| 请求参数
|
3.车型库-热销排行榜
| 请求地址 | 待定
|
| method | get
|
| login | 否
|
| 返回格式 | json
|
| 缓存方式
|
| 缓存时间
|
| 请求参数
|
| 参数名 | 类型 | 必须 | 说明
|
| 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.车型库-搜索-关键词
| 请求地址 | 待定
|
| method | get
|
| login | 否
|
| 返回格式 | json
|
| 缓存方式
|
| 缓存时间
|
| 请求参数
|
| 参数名 | 类型 | 必须 | 说明
|
| - | - | - | -
|
| 返回参数
|
| 参数名 | 类型 | 必须 | 说明
|
| list | array | 是 | 分页结果列表
|
| 列表项数据格式说明
|
| | 参数名 | 类型 | 必须 | 说明
|
| | seriesid | number | 是 | 车系id
|
| | namel | number | 是 | 车系名称
|
6. 车型库-搜索
| 请求地址 | 待定
|
| method | get
|
| login | 否
|
| 返回格式 | json
|
| 缓存方式
|
| 缓存时间
|
| 请求参数
|
| 参数名 | 类型 | 必须 | 说明
|
| keyword | string | 是 | 用户输入的搜索关键字
|
| 返回参数
|
| 参数名 | 类型 | 必须 | 说明
|
| total | number | 是 | 数据总个数
|
| list | array | 是 | 分页结果列表
|
| 列表项数据格式说明
|
| | 参数名 | 类型 | 必须 | 说明
|
| | seriesid | number | 是 | 车系id
|
| | namel | number | 是 | 车系名称
|
2.1 车系
1.车系-综述 =
| URL | 待定
|
| method | get
|
| login | 否
|
| 返回格式 | html web page
|
| 缓存方式
|
| 缓存时间
|
| 请求参数
|
| 参数名 | 类型 | 必须 | 说明
|
| seriesid | string | 是 | 车系id
|
| city | string | 是 | 用户所在城市
|
| 返回参数
|
| 参数名 | 类型 | 必须 | 说明
|
| - | - | - | -
|
| 页面内协议说明
|
| 参数名 | 类型 | 必须 | 说明
|
| - | - | - | -
|
2.车系-优惠
| URL | 待定
|
| method | get
|
| login | 否
|
| 返回格式 | json
|
| 缓存方式
|
| 缓存时间
|
| 请求参数
|
| 参数名 | 类型 | 必须 | 说明
|
| 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.车系-参配
| URL | 待定
|
| method | get
|
| login | 否
|
| 返回格式 | json
|
| 缓存方式
|
| 缓存时间
|
| 请求参数
|
| 参数名 | 类型 | 必须 | 说明
|
| seriesid | string | 是 | 车系id
|
| 返回参数
|
| 参数名 | 类型 | 必须 | 说明
|
| total | number | yes | 优惠总个数
|
| list | array | yes | 优惠数据列表
|
| 列表项数据格式说明
|
| 参数名 | 类型 | 必须 | 说明
|
| 待定 | - | 是 | -
|
4.车系-点评
| URL | 待定
|
| method | get
|
| login | 否
|
| 返回格式 | html web page
|
| 缓存方式
|
| 缓存时间
|
| 请求参数
|
| 参数名 | 类型 | 必须 | 说明
|
| seriesid | string | 是 | 车系id
|
| 返回参数
|
| 参数名 | 类型 | 必须 | 说明
|
| - | - | - | -
|
| 页面内协议说明
|
| 参数名 | 类型 | 必须 | 说明
|
| - | - | - | -
|
5.车系-资讯
| URL | 待定
|
| method | get
|
| login | 否
|
| 返回格式 | json
|
| 缓存方式
|
| 缓存时间
|
| 请求参数
|
| 参数名 | 类型 | 必须 | 说明
|
| 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)车型-综述
| URL | 待定
|
| method | get
|
| login | 否
|
| 返回格式 | html web page
|
| 缓存方式
|
| 缓存时间
|
| 请求参数
|
| 参数名 | 类型 | 必须 | 说明
|
| carid | string | 是 | 车系id
|
| 返回参数
|
| 参数名 | 类型 | 必须 | 说明
|
| - | - | - | -
|
| 页面内协议说明
|
| 参数名 | 类型 | 必须 | 说明
|
| - | - | - | -
|
2)车型-参配
| URL | 待定
|
| method | get
|
| login | 否
|
| 返回格式 | html web page
|
| 缓存方式
|
| 缓存时间
|
| 请求参数
|
| 参数名 | 类型 | 必须 | 说明
|
| carid | string | 是 | 车系id
|
| 返回参数
|
| 参数名 | 类型 | 必须 | 说明
|
| - | - | - | -
|
| 页面内协议说明
|
| 参数名 | 类型 | 必须 | 说明
|
| - | - | - | -
|
3)车型-点评
| URL | 待定
|
| method | get
|
| login | 否
|
| 返回格式 | html web page
|
| 缓存方式
|
| 缓存时间
|
| 请求参数
|
| 参数名 | 类型 | 必须 | 说明
|
| carid | string | 是 | 车系id
|
| 返回参数
|
| 参数名 | 类型 | 必须 | 说明
|
| - | - | - | -
|
| 页面内协议说明
|
| 参数名 | 类型 | 必须 | 说明
|
| - | - | - | -
|
4)车型-团购/陪购
| URL | 待定
|
| method | get
|
| login | 否
|
| 返回格式 | html web page
|
| 缓存方式
|
| 缓存时间
|
| 请求参数
|
| 参数名 | 类型 | 必须 | 说明
|
| carid | string | 是 | 车系id
|
| 返回参数
|
| 参数名 | 类型 | 必须 | 说明
|
| - | - | - | -
|
| 页面内协议说明
|
| 参数名 | 类型 | 必须 | 说明
|
| - | - | - | -
|
5)车型-优惠详情
| URL | 待定
|
| method | get
|
| login | 否
|
| 返回格式 | html web page
|
| 缓存方式
|
| 缓存时间
|
| 请求参数
|
| 参数名 | 类型 | 必须 | 说明
|
| carid | string | 是 | 车系id
|
| 返回参数
|
| 参数名 | 类型 | 必须 | 说明
|
| - | - | - | -
|
| 页面内协议说明
|
| 参数名 | 类型 | 必须 | 说明
|
| - | - | - | -
|
2.2 找车
1) 筛选-快速查找符合条件个数
| URL | 待定
|
| method | get
|
| login | 否
|
| 返回格式 | json
|
| 缓存方式
|
| 缓存时间
|
| 请求参数
|
2) 筛选-符合条件列表
| URL | 待定
|
| method | get
|
| login | 否
|
| 返回格式 | json
|
| 缓存方式
|
| 缓存时间
|
| 请求参数
|
2.3 优惠
1) 优惠-优惠列表
| URL | 待定
|
| method | get
|
| login | 否
|
| 返回格式 | json
|
| 缓存方式
|
| 缓存时间
|
| 请求参数
|
2.4 团购
1) 团购-团购列表(含筛选)
| 请求地址 | 待定
|
| method | get
|
| login | 否
|
| 返回格式 | json
|
| 缓存方式
|
| 缓存时间
|
| 请求参数
|
| 参数名 | 类型 | 必须 | 说明
|
| 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) 团购-在线报名
| URL | 待定
|
| method | get
|
| login | 否
|
| 返回格式 | html web page
|
| 缓存方式
|
| 缓存时间
|
| 请求参数
|
| 参数名 | 类型 | 必须 | 说明
|
| carid | string | 是 | 车系id
|
| 返回参数
|
| 参数名 | 类型 | 必须 | 说明
|
| - | - | - | -
|
| 页面内协议说明
|
| 参数名 | 类型 | 必须 | 说明
|
| - | - | - | -
|
3) 团购-活动详细-
| URL | 待定
|
| method | get
|
| login | 否
|
| 返回格式 | html web page
|
| 缓存方式
|
| 缓存时间
|
| 请求参数
|
| 参数名 | 类型 | 必须 | 说明
|
| carid | string | 是 | 车系id
|
| 返回参数
|
| 参数名 | 类型 | 必须 | 说明
|
| - | - | - | -
|
| 页面内协议说明
|
| 参数名 | 类型 | 必须 | 说明
|
| - | - | - | -
|
2.5 我的
1) 我的-订阅列表
本地保存的数据-无接口
2) 我的-团购列表
本地保存的数据-无接口
3) 我的-陪购列表
本地保存的数据-无接口
4) 我的-消息推送定制
| 请求地址 | 待定
|
| method | post
|
| login | 是
|
| 返回格式 | json
|
| 缓存方式
|
| 缓存时间
|
| 请求参数
|
| 参数名 | 类型 | 必须 | 说明
|
| 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) 购车计算器
| 请求地址 | 待定
|
| method | get
|
| login | 否
|
| 返回格式 | json
|
| 缓存方式
|
| 缓存时间
|
| 请求参数
|
| 参数名 | 类型 | 必须 | 说明
|
| autoid | string | 是 | 车型id,需要想要购买的车型的id
|
| price | string | 是 | 裸车价,单位元
|
| ifloan | bool | 是 | 是否贷款购车
|
| downpayment | string | 否 | 首付款,非贷款购车时为空
|
| years | number | 否 | 还款年限,非贷款购车时为空
|
| 返回参数
|
| 参数名 | 类型 | 必须 | 说明
|
| url | string | 是 | 计算结果web页面地址
|
2) 车险计算器
| 请求地址 | 待定
|
| method | get
|
| login | 否
|
| 返回格式 | json
|
| 缓存方式
|
| 缓存时间
|
| 请求参数
|
| 参数名 | 类型 | 必须 | 说明
|
| autoid | string | 是 | 车型id,车险对应的车型的id
|
| price | string | 是 | 裸车价,单位元
|
| 返回参数
|
| 参数名 | 类型 | 必须 | 说明
|
| url | string | 是 | 计算结果web页面地址
|
3) 车型对比器
| 请求地址 | 待定
|
| method | get
|
| login | 否
|
| 返回格式 | json
|
| 缓存方式
|
| 缓存时间
|
| 请求参数
|
| 参数名 | 类型 | 必须 | 说明
|
| - | string | 是 | -
|
| - | string | 是 | -
|
| 返回参数
|
| 参数名 | 类型 | 必须 | 说明
|
| url | string | 是 | 计算结果web页面地址
|