wiki:pcauto_BuyAuto_1.0.0

Version 28 (modified by limingjiu, 12 years ago) (diff)

--

1、需求描述

2、接口文档

2.0 辅助接口:获取当前用户的可团购车系列表

请求地址待定
methodget
login
返回格式json
缓存方式
缓存时间
请求参数
参数名类型必须说明
citystring用户所在城市
返回参数
参数名类型必须说明
listarray有团购数据车系结果列表
list项结构
sidnumber车系id
namelstring车系名

2.1 车型库

1.车型库-车系列表

请求地址 待定
method get
login
返回格式json
缓存方式
缓存时间
请求参数

2.车型库-车系-车型列表

URL 待定
method get
login
返回格式json
缓存方式
缓存时间
请求参数

3.车型库-热销排行榜

请求地址待定
methodget
login
返回格式json
缓存方式
缓存时间
请求参数
参数名类型必须说明
typenumber1~7分别代表:微型、小型车、紧凑车型,中型车、中大型车
pagenumber请求分页
pagesizenumber请求分页大小
返回参数
参数名类型必须说明
totalnumber数据总个数
listarray分页结果列表
列表项数据格式说明
参数名类型必须说明
cidnumber数据总个数
namelnumber数据总个数
thumbstring文章缩略图
pricestring数据总个数
typestring车型分类
activitiesstring是否有团购活动

5.车型库-搜索-关键词

请求地址待定
methodget
login
返回格式json
缓存方式
缓存时间
请求参数
参数名类型必须说明
----
返回参数
参数名类型必须说明
listarray分页结果列表
列表项数据格式说明
参数名类型必须说明
seriesidnumber车系id
namelnumber车系名称

6. 车型库-搜索

请求地址待定
methodget
login
返回格式json
缓存方式
缓存时间
请求参数
参数名类型必须说明
keywordstring用户输入的搜索关键字
返回参数
参数名类型必须说明
totalnumber数据总个数
listarray分页结果列表
列表项数据格式说明
参数名类型必须说明
seriesidnumber车系id
namelnumber车系名称

2.1 车系

1.车系-综述 =

URL 待定
method get
login
返回格式html web page
缓存方式
缓存时间
请求参数
参数名类型必须说明
seriesidstring车系id
citystring用户所在城市
返回参数
参数名类型必须说明
----
页面内协议说明
参数名类型必须说明
----

2.车系-优惠

URL 待定
method get
login
返回格式json
缓存方式
缓存时间
请求参数
参数名类型必须说明
seriesidstring车系id
citystring用户所在城市
返回参数
参数名类型必须说明
totalnumberyes优惠总个数
listarrayyes优惠数据列表
list列表项格式
参数名类型必须说明
cid-车型id
cnamenumber车型id
cnamestring车型名称
pricenumber原价
offpricenumber优惠价
shopsarray经销商
shops列表项格式
参数名类型必须说明
sid-经销商id
namenumber车型id
citystring所在城市
pricenumber原价
offpricenumber优惠价
telephonestring电话号码
telephonestring电话号码
flagnumber是否4s店

3.车系-参配

URL 待定
method get
login
返回格式json
缓存方式
缓存时间
请求参数
参数名类型必须说明
seriesidstring车系id
返回参数
参数名类型必须说明
totalnumberyes优惠总个数
listarrayyes优惠数据列表
列表项数据格式说明
参数名类型必须说明
待定--

4.车系-点评

URL 待定
method get
login
返回格式html web page
缓存方式
缓存时间
请求参数
参数名类型必须说明
seriesidstring车系id
返回参数
参数名类型必须说明
----
页面内协议说明
参数名类型必须说明
----

5.车系-资讯

URL 待定
method get
login
返回格式json
缓存方式
缓存时间
请求参数
参数名类型必须说明
seriesidstring车系id
pagenumber分页页码
pagesizenumber分页大小
infotypenumber资讯类型:0、全部、1、报价、3、其他(待定)
返回参数
参数名类型必须说明
totalnumberyes资讯总个数
listarrayyes资讯列表分页数据
列表项格式
参数名类型必须说明
thumbstring文章缩略图
titlestring文章标题
typestring文章类型
datestring文章时间

2.2 车型

1)车型-综述

URL 待定
method get
login
返回格式html web page
缓存方式
缓存时间
请求参数
参数名类型必须说明
caridstring车系id
返回参数
参数名类型必须说明
----
页面内协议说明
参数名类型必须说明
----

2)车型-参配

URL 待定
method get
login
返回格式html web page
缓存方式
缓存时间
请求参数
参数名类型必须说明
caridstring车系id
返回参数
参数名类型必须说明
----
页面内协议说明
参数名类型必须说明
----

3)车型-点评

URL 待定
method get
login
返回格式html web page
缓存方式
缓存时间
请求参数
参数名类型必须说明
caridstring车系id
返回参数
参数名类型必须说明
----
页面内协议说明
参数名类型必须说明
----

4)车型-团购/陪购

URL 待定
method get
login
返回格式html web page
缓存方式
缓存时间
请求参数
参数名类型必须说明
caridstring车系id
返回参数
参数名类型必须说明
----
页面内协议说明
参数名类型必须说明
----

5)车型-优惠详情

URL 待定
method get
login
返回格式html web page
缓存方式
缓存时间
请求参数
参数名类型必须说明
caridstring车系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) 团购-团购列表(含筛选)

请求地址待定
methodget
login
返回格式json
缓存方式
缓存时间
请求参数
参数名类型必须说明
seriesidstring筛选条件,如果全部车型,则为空,多个车系的情况,以,号隔开
citystring用户所在地
pagenumber请求分页
pagesizenumber请求分页大小
返回参数
参数名类型必须说明
totalnumber数据总个数
listarray分页结果列表
列表项格式
参数名类型必须说明
sidnumber车系id
namelnumber车系活动名
thumbstring车系预览图
pricestring显示价格
offvaluestring优惠价格
enddatestring结束时间
signupcountstring报名人数

2) 团购-在线报名

URL 待定
method get
login
返回格式html web page
缓存方式
缓存时间
请求参数
参数名类型必须说明
caridstring车系id
返回参数
参数名类型必须说明
----
页面内协议说明
参数名类型必须说明
----

3) 团购-活动详细-

URL 待定
method get
login
返回格式html web page
缓存方式
缓存时间
请求参数
参数名类型必须说明
caridstring车系id
返回参数
参数名类型必须说明
----
页面内协议说明
参数名类型必须说明
----

2.5 我的

1) 我的-订阅列表

     本地保存的数据-无接口

2) 我的-团购列表

    本地保存的数据-无接口

3) 我的-陪购列表

    本地保存的数据-无接口

4) 我的-消息推送定制

请求地址待定
methodpost
login
返回格式json
缓存方式
缓存时间
请求参数
参数名类型必须说明
devicestokenstring设备push消息对应的token值
switchbool是否接收push消息
distubmodebool夜间勿扰模式
channelsstring团购、陪购、优惠的内容定制,定制:1,不定制:0,如3个都定制的情况,传:1,1,1,只定制团购,其他不定制,传:1,0,0
返回参数
参数名类型必须说明
codenumber消息定制结果码,0:成功,其他失败
msgstring错误的情况下的,错误信息

2.6 工具

1) 购车计算器

请求地址待定
methodget
login
返回格式json
缓存方式
缓存时间
请求参数
参数名类型必须说明
autoidstring车型id,需要想要购买的车型的id
pricestring裸车价,单位元
ifloan bool是否贷款购车
downpaymentstring首付款,非贷款购车时为空
yearsnumber还款年限,非贷款购车时为空
返回参数
参数名类型必须说明
urlstring计算结果web页面地址

2) 车险计算器

请求地址待定
methodget
login
返回格式json
缓存方式
缓存时间
请求参数
参数名类型必须说明
autoidstring车型id,车险对应的车型的id
pricestring裸车价,单位元
返回参数
参数名类型必须说明
urlstring计算结果web页面地址

3) 车型对比器

请求地址待定
methodget
login
返回格式json
缓存方式
缓存时间
请求参数
参数名类型必须说明
-string-
-string-
返回参数
参数名类型必须说明
urlstring计算结果web页面地址