wiki:pcauto_BuyAuto_1.0.0

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

--

1、需求描述

2、接口文档

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

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

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

返回参数

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

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是分页结果列表
列表项数据格式说明
参数名类型必须说明
cidnumber是数据总个数
namelnumber是数据总个数
thumbstring是文章缩略图
pricestring是数据总个数
typestring是车型分类
activitiesstring是是否有团购活动

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
citystring是用户所在城市
返回参数
参数名类型必须说明
----
页面内协议说明
参数名类型必须说明
----

2.车系-优惠

[请参考：2.3.1章节]

3.车系-参配

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

参数名类型必须说明
seriesidstring是车系id
返回参数
参数名类型必须说明
totalnumberyes优惠总个数
listarrayyes优惠数据列表
列表项数据格式说明
参数名类型必须说明
待定-是-

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资讯列表分页数据
列表项格式
参数名类型必须说明
thumbstring是文章缩略图
titlestring是文章标题
typestring是文章类型
datestring是文章时间

2.2 车型

1)车型-综述

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

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

2)车型-参配

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

参数名类型必须说明
caridstring是车系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页面
缓存方式：无
缓存时间：无
请求参数

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

5)车型-优惠详情

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

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

2.2 找车

1) 筛选-快速查找符合条件个数

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

2) 筛选-符合条件列表

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

2.3 优惠

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

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

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

返回参数

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

2.4 团购

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

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

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

2) 团购-在线报名

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

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

3) 团购-活动详细-

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

参数名类型必须说明
caridstring是车系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"
       }
       ...
     ]
   },
   ...
 ]
}