wiki:pcauto_BuyAuto_1.0.0

Version 60 (modified by yangbo, 12 years ago) (diff)

--

1、需求描述

产品原型

  v3   v2   v1

2、接口文档

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

备注：搜索接口，搜索某品牌下的车系
请求URL： 待定
HTTP请求方式：get
是否需要登录：否
返回格式：json
缓存方式：无
缓存时间：无
请求参数

参数名类型必须说明
cityidstring是用户所在城市

返回参数

参数名类型必须说明
listarray是有团购数据车系结果列表
list项结构
参数名类型必须说明
seriesidnumber是车系id
namestring是车系名

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得到车系列表
请求URL： http://mrobot.pcauto.com.cn/v3/price/getSerialListByBrandId/60
HTTP请求方式：get
是否需要登录：否
返回格式：json
缓存方式：无
缓存时间：5分钟 请求参数：

idnumber品牌id

求后端URL： http://price.pcauto.com.cn/interface/iphone/serialGroup_list_v2.jsp?bid=60
请求后端参数：

idnumber品牌id

返回参数，需要增加一个字段：

参数名类型必须说明
salestatusnumber必须1、在售、2停售

3.车型库-热销排行榜

备注：搜索接口，搜索某品牌下的车系
请求URL： 待定
HTTP请求方式：get
是否需要登录：否
返回格式：json
缓存方式：无
缓存时间：无
请求参数

参数名类型必须说明
typenumber是1~7分别代表：微型、小型车、紧凑车型，中型车、中大型车
pagenumber是请求分页
pagesizenumber是请求分页大小
返回参数
参数名类型必须说明
totalnumber是数据总个数
listarray是分页结果列表
列表项数据格式说明
参数名类型必须说明
seriesidnumber是车系id
namelnumber是车系名称
thumbstring是列表预览图
pricestring是价格
typestring是车型分类

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

备注：动态获取搜索关键字，由编辑在cms里维护
请求URL： http://mrobot.pcauto.com.cn/v3/price/modelsForSearch
HTTP请求方式：get
是否需要登录：否
返回格式：json
缓存方式：无
缓存时间：无
请求参数：无
返回参数： 

{
"modelList": [{
    "id": 123,
     "name": "蒙迪欧"
  }]
}

请求后端URL： http://www.pcauto.com.cn/client/news/tghd/1401/intf2907.js

6. 车型库-车系搜索

备注：搜索接口，搜索某品牌下的车系
请求URL： http://mrobot.pcauto.com.cn/v3/price/models/search?keyword=大众&pageNo=1&pageSize=1000
HTTP请求方式：get
是否需要登录：否
返回格式：json
缓存方式：无
缓存时间：无
请求参数:

keyword查询条件
pageNo页码
pageSize一页条数

请求后端URL： http://price.pcauto.com.cn/interface/iphone/search_serial_group_list.jsp?pageNo=1&pageSize=1000&keyword=大众
请求后端参数:

keyword查询条件
pageNo页码
pageSize一页条数

2.1 车系

1.车系-综述

备注：搜索接口，搜索某品牌下的车系
请求URL： 待定
HTTP请求方式：get
是否需要登录：否
返回格式：html页面
缓存方式：无
缓存时间：无
请求参数

参数名类型必须说明
seriesidstring是车系id
cityidstring是用户所在城市
返回参数
参数名类型必须说明
----
页面内协议说明
参数名类型必须说明
----

2.车系-优惠

[请参考：2.3.1章节]

3.车系-参配

备注：搜索接口，搜索某品牌下的车系
请求URL： 待定
HTTP请求方式：get
是否需要登录：否
返回格式：html页面
缓存方式：无
缓存时间：无
请求参数

参数名类型必须说明
seriesidstring是车系下所有车型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.车系-资讯

备注：搜索接口，搜索某品牌下的车系
请求URL： 待定
HTTP请求方式：get
是否需要登录：否
返回格式：json
缓存方式：无
缓存时间：无
请求参数

参数名类型必须说明
seriesidstring是车系id
pagenumber是分页页码
pagesizenumber是分页大小
infotypenumber是资讯类型：0、全部、1、新闻 2、评测 3、导购 4、行情
返回参数
参数名类型必须说明
totalnumberyes资讯总个数
listarrayyes资讯列表分页数据
列表项格式
参数名类型必须说明
infoidstring是文章id
thumbstring是文章缩略图
titlestring是文章标题
typestring是文章类型
datestring是文章时间

2.2 车型

1)车型-综述

备注：搜索接口，搜索某品牌下的车系
请求URL： 待定
HTTP请求方式：get
是否需要登录：否
返回格式：html页面
缓存方式：无
缓存时间：无
请求参数

参数名类型必须说明
modelidstring是车系id
返回参数
参数名类型必须说明
----
页面内协议说明
参数名类型必须说明
----

2)车型-参配

备注：搜索接口，搜索某品牌下的车系
请求URL： 待定
HTTP请求方式：get
是否需要登录：否
返回格式：html页面
缓存方式：无
缓存时间：无
请求参数

参数名类型必须说明
modelidstring是车系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)车型-团购/陪购

备注：搜索接口，搜索某品牌下的车系
请求URL： 待定
HTTP请求方式：get
是否需要登录：否
返回格式：html页面
缓存方式：无
缓存时间：无
请求参数

参数名类型必须说明
modelidstring是车系id
返回参数
参数名类型必须说明
----
页面内协议说明
参数名类型必须说明
----

5)车型-优惠详情

备注：搜索接口，搜索某品牌下的车系
请求URL： 待定
HTTP请求方式：get
是否需要登录：否
返回格式：html页面
缓存方式：无
缓存时间：无
请求参数

参数名类型必须说明
modelidstring是车系id
返回参数
参数名类型必须说明
----
页面内协议说明
参数名类型必须说明
----

2.2 找车

1) 筛选-精准选车条件

备注：找车动态赛选-条件获取
请求URL： 待定 ，（可参考资讯客户端： http://mrobot.pcauto.com.cn/v3/price/models/criterionv36?v=4.0.0）[[BR]] HTTP请求方式：get
是否需要登录：否
返回格式：json
缓存方式：无
缓存时间：无
请求参数：无
返回参数： 

{
    "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) 筛选-快速查找符合条件个数/列表

备注：筛选条件变后，自动获取符合筛选条件的车型个数
请求URL： 待定 ,可参考： http://trac.pc.com.cn/iphone/wiki/intfs_new#a2.8.3精准选车条件
HTTP请求方式：get
是否需要登录：否
返回格式：json
缓存方式：无
缓存时间：无
请求参数

参数名类型必须说明
qryfornumber是1、请求个数，2、请求列表
pagenumber否请求分页页码，qryfor=1时，可不传
pagesizenumber否请求分页大小，qryfor=1时，可不传
queryJsonstring是动态组合的json数据，根据筛选条件组装 
queryJson={[
   {"key":"cluster_std_displacement",
    "value":"0",
   },
   {"key":"cluster_std_displacement",
    "value":"0",
   },
   .....
]}

返回参数

参数名类型必须说明
total number是符合筛选条件的车系总个数
listarray否qryfor=1时，可不传
list列表项格式
参数名类型必须说明
seriesid-是车系id
namenumber是车型名称

2.3 优惠

1) 优惠-优惠列表 （需要修改/重做）

备注：搜索接口，搜索某品牌下的车系
请求URL： http://mrobot.pcauto.com.cn/v3/price/activityList/{areaId}?pageNo=1&pageSize=20
HTTP请求方式：get
是否需要登录：否
返回格式：json
缓存方式：无
缓存时间：无
请求参数

参数名类型必须说明
seriesidstring否筛选条件，如果全部车型，则为空，多个车系的情况，以，号隔开
cityidstring是用户所在地
pagenumber是请求分页
pagesizenumber是请求分页大小

返回参数

参数名类型必须说明
total number是优惠总个数
listaarray是分页数据列表
list列表项格式
参数名类型必须说明
modelid-是车型id
namestring是车型名称
pricenumber是原价
offpricenumber是优惠价
shopsarray是经销商
shops列表项格式
参数名类型必须说明
shopid-是经销商id
namenumber是车型id
citystring是所在城市
pricenumber是原价
offpricenumber是优惠价
telephonestring是电话号码
telephonestring是电话号码
flagnumber是是否4s店

2.4 团购

1) 团购-团购列表(含筛选)

备注：搜索接口，搜索某品牌下的车系
请求URL： 待定
HTTP请求方式：get
是否需要登录：否
返回格式：json
缓存方式：无
缓存时间：无
请求参数

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

2) 团购-在线报名

备注：搜索接口，搜索某品牌下的车系
请求URL： 待定
HTTP请求方式：get
是否需要登录：否
返回格式：html页面
缓存方式：无
缓存时间：无
请求参数

参数名类型必须说明
modelidstring是车系id
返回参数
参数名类型必须说明
----
页面内协议说明
参数名类型必须说明
----

3) 团购-活动详细-

备注：搜索接口，搜索某品牌下的车系
请求URL： 待定
HTTP请求方式：get
是否需要登录：否
返回格式：html页面
缓存方式：无
缓存时间：无
请求参数

参数名类型必须说明
modelidstring是车系id
返回参数
参数名类型必须说明
----
页面内协议说明
参数名类型必须说明
----

2.5 我的

1) 我的-订阅列表

     本地保存的数据-无接口

2) 我的-团购列表

    本地保存的数据-无接口

3) 我的-陪购列表

    本地保存的数据-无接口

4) 我的-消息推送定制

备注：搜索接口，搜索某品牌下的车系
请求URL： 待定
HTTP请求方式：get
是否需要登录：否
返回格式：json
缓存方式：无
缓存时间：无
请求参数

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

2.6 工具

1) 购车计算器/车险计算器

备注：搜索接口，搜索某品牌下的车系
请求URL： 待定
HTTP请求方式：get
是否需要登录：否
返回格式：json
缓存方式：无
缓存时间：无
请求参数

参数名类型必须说明
modelidstring是车型id,需要想要购买的车型的id
pricestring是裸车价，单位元
typenumber是1、全款购车 2、贷款购车 3、车险计算
downpaymentstring否首付款，非贷款购车时为空
yearsnumber否还款年限，非贷款购车时为空
返回参数
参数名类型必须说明
mustobject是必要花费
insuranceobject是商业保险花费

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"
       }
       ...
     ]
   },
   ...
 ]
}