![(please configure the [header_logo] section in trac.ini)](http://www1.pconline.com.cn/hr/2009/global/images/logo.gif){kind=logo}
| Version 24 (modified by limingjiu, 12 years ago) (diff) |
|---|
1、需求描述
2、接口文档
2.1 车型库
1.车型库-车系列表
| 请求地址 | 待定 |
| method | get |
| login | 否 |
| 返回格式 | json |
| 缓存方式 | |
| 缓存时间 | |
| 请求参数 |
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 | 是 | 数据总个数 |
| 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 | 优惠数据列表 |
| 列表项数据格式说明 | |||
| 参数名 | 类型 | 必须 | 说明 |
| 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 | 否 |
| 返回格式 | json |
| 缓存方式 | |
| 缓存时间 | |
| 请求参数 |
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) 团购-团购列表(含筛选)
| URL | 待定 |
| method | get |
| login | 否 |
| 返回格式 | json |
| 缓存方式 | |
| 缓存时间 | |
| 请求参数 |
2) 团购-在线报名
| URL | 待定 |
| method | get |
| login | 否 |
| 返回格式 | json |
| 缓存方式 | |
| 缓存时间 | |
| 请求参数 |
2) 陪购-在线报名
| URL | 待定 |
| method | get |
| login | 否 |
| 返回格式 | json |
| 缓存方式 | |
| 缓存时间 | |
| 请求参数 |
3) 团购-活动详细-
| URL | 待定 |
| method | get |
| login | 否 |
| 返回格式 | json |
| 缓存方式 | |
| 缓存时间 | |
| 请求参数 |
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页面地址 |
