wiki:pcauto_BuyAuto_1.1.0

Version 55 (modified by oujianqiang, 11 years ago) (diff)

--

Table of Contents

  1. 1.基本约定
  2. 2.接口列表
    1. 2.1 找车
      1. 2.1.1. 筛选-快速查找符合条件个数/列表
    2. 2.2 优惠
      1. 2.2.1. 优惠-优惠列表
    3. 2.3 团购活动
      1. 2.3.1 团购活动列表
      2. 2.3.2 发起团购
      3. 2.3.3 团购活动详情页
    4. 2.4 询底价|我要优惠
      1. 2.4.1 询底价
      2. 2.4.2 我要优惠
    5. 2.5 车系
      1. 2.5.1.车系-综述
      2. 2.5.2.车系-优惠
    6. 2.6 车型
      1. 2.6.1.车型-综述

1.基本约定

接口通用参数
req_enc=utf-8(必须放url后面)
resp_enc=utf-8(必须放url后面)
common_session_id=xxxx(以cookies中的优先)

接口URL: 接口URL
必填参数：参数名=xxx(多种情况用括号解析)
非必填参数：参数名=xxx(多种情况用括号解析)
说明文档参数：添加某特定参数可以直接看接口文档
是否需要登录：是,否
返回格式：json,ssi,xml
缓存方式：接口缓存（接口中返回的响应头里面的 Cache-Control），对象缓存（）
缓存时间：缓存时间
返回结果：结果可能情况

2.接口列表

2.1 找车

2.1.1. 筛选-快速查找符合条件个数/列表

(后端接口未上线，暂时无法测试）
说明：此接口是在前版本的基础上新增了sortType的请求参数，用于指示返回结果的排序方式
备注：筛选条件变后，自动获取符合筛选条件的车型个数
1、用来请求找车首页的筛选条件
2、支持关联筛选，当用户的选择条件变更时，需要重新请求，请求的返回数据中：fact字段中，列出了每个筛选条件的可选值
3、list用来区分请求个数还是请求列表


Mrobot请求URL：（暂无）
后端请求测试URL：
后端请求正式URL：
HTTP请求方式：get
是否需要登录：否
返回格式：json
缓存方式：无
缓存时间：无
请求参数：无

参数名类型必须说明
ridstring是用户所在地区id
liststring是筛选个数、筛选列表，取值true/false
psstring否最小价格
pestring否最大价格
jbstring否级别
plstring否排量
bsxstring否变速箱
mkidstring否结构
countrystring否国别
rlstring否燃料
zwstring否座位
qdfsstring否驱动
pzstring否配置
pageNostring否分页
pageSizestring否分页大小
sortTypestring否排序方式，1：按热度， 2：按价格由高到低，3：按价格由低到高，默认值为1

2.2 优惠

2.2.1. 优惠-优惠列表

(接口未上线，请直接使用后端请求测试URL进行测试）
说明：此接口与前版本区别在于，在返回结果的models成员元素中新增了几个字段，分别是giftPackage（礼包优惠），modelType（现车情况）
Mrobot请求URL： http://mrobot.pcauto.com.cn/buy/price/promotionList?areaId=1&pageSize=20&pageNo=1
后端请求正式环境URL： http://price.pcauto.com.cn/dealer/interface/app/market_groupby_model_json.jsp
后端请求测试环境URL：
 http://dev3.pcauto.com.cn:8001/dealer/interface/app/market_groupby_model_json.jsp?pageNo=1&pageSize=10&areaId=3
HTTP请求方式：get
返回格式：json
请求参数 

areaId：城市id
mfId: 厂商id
sgId: 车系id
modelId：车型id
pageNo：第几页
pageSize：每页大小
callback：js回调函数名称

返回结果 

{
 total: 143,			//团购总数
 pageCount: 15,		//团购总页数
 pageNo: 1,			//第几页
 pageSize: 10,		//每页大小
 models: [				//活动信息列表
  {
  modelId: 7616,			//车型id
  price: 7.78,			// 车型官方价
  name: "锐欧 2007款 1.4 手动 豪华型",	//车型名称
  discountPrice: 5.78,	//促销价
  discount : 20000,			//降幅
  giftPackage : "送10000元礼包",	//礼包优惠
  modelType : "现车充足",	        //现车情况
  dealers:[
   {
    dealerId : 32046,		// 经销商ID
    name : 庞大东风悦达起亚,	// 经销商简称 
    price : 7.78,			//车型官方价
    discountPrice: 5.78,	//行情促销价
    discount : 20000,			//降幅
    dealerPrice : 7.78,		// 经销商报价
    is4S : 1,		// 是否4S店，1：是，0：否
    is400 : 1,	// 是否400电话，1：是，0：否
    phone : 400-670-5680, 	//电话
    namelistRange : 1			// 销售范围，0:本市，1:本省，2:全国
  },
  ...
 ]
},
...
]
}

2.3 团购活动

2.3.1 团购活动列表

    mrobot测试接口：http://v36.pcauto.com.cn/buy/price/activityListv11?pageNo=1&pageSize=1&regionId=3
    （QA阶段使用此接口，QA通过换回线上接口。）
    请求mrobot接口：http://mrobot.pcauto.com.cn/buy/price/activityListv11?pageNo=1&pageSize=1&regionId=3
    应用端接口：http://dev3.pcauto.com.cn:9977/autoMall/interface/auto_mall_gct_list_json.jsp?regionId=3
    请求参数：
    regionId：城市ID（必须，默认值1）
    manufacturerId：车厂ID（可选）
    pageNo：页码（默认1）
    pageSize：每页条数（默认20）
    返回结果：
    {
    "data": [
        {
            "banner": "http://img.pconline.com.cn/images/upload/upc/tx/tuangou/1411/14/c0/34350_1415973025778_500x200.jpg",  //购车团主图500x200px
            "beginTime": "2014/11/14 00:00:00",   //开始时间
            "brandName": "凯迪拉克(进口)",        //车厂名称
            "endTime": "2014/12/12 23:59:59",     //结束时间
            "id": 349,                            //购车团ID
            "maxDiscount": 5,                     //最高优惠,单位万.
            "orderCount": 2,                      //活动报名人数
            "photo": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1403/18/c3/32200468_1395112948222_180x135.jpg",  //最大优惠车系主图,180x135像素 
            "priceTitle": "最高优惠",             //价格标题
            "serialGroupNames": "凯迪拉克SRX",    //车系名称串(最多5个)
            "title": "凯迪拉克厚惠无欺 万元优惠超值惊喜",   //购车团标题
            "url": "http://dev3.pcauto.com.cn:9977/gct/r3/g349/"  //购车团链接
        }
    ],
    "pageCount": 14,   //总页数
    "pageNo": 1,       //页码
    "pageSize": 1,     //页面条数
    "total": 14        //总条数
    }

2.3.2 发起团购

    mrobot测试接口：http://v36.pcauto.com.cn/v3/search/mallPost
    （QA阶段使用此接口，QA通过换回线上接口。）
    请求方式：POST
    请求mrobot接口：http://mrobot.pcauto.com.cn/v3/search/mallPost
    应用端接口：http://dev3.pcauto.com.cn:9977/autoMall/gct/action/do_order.jsp
    请求参数格式：
    key：param
    value：
    {
      "userName": "huixuan",
      "regionId": 1,
      "isInitMsg": 1,
      "origin": 3,
      "phone": 13360009613,
      "carSerialId" : 4313,
      "referer" : "http://mrobot.pcauto.com.cn/autobuy/"
    }
    返回参数：
    ｛
        code：200，
        msg：报名成功
     ｝
204 - 表单必填参数不完整
205 - 活动结束，不能报名
206 - 活动未审核，不能报名
207 - 活动审核失败，不能报名
500 - 系统错误
    注意: （关于referer值）购车APP填写固定值:http://mrobot.pcauto.com.cn/autobuy/   用于记录报名来源于购车app
           (关于carSerialId值）isInitMsg=1时为必须
    参数说明如下表：
参数名称参数名类型说明是否必须
车型ID modelId LongisInitMsg=0时必须 必须
车系IDsgId LongisInitMsg=0时必须必须
团购ID tsgId LongisInitMsg=0时必须 必须
经销商IDdealerIdLong默认0必须
网友姓名userNameString 必须
网友城市regionIdLong 必须
网友电话phoneString 必须
来源URLrefererString见注意必须
平台来源originint0未知,1:web,2:wap,3:IOS,4:Android,5:WP,6:杂志必须
是否三人行isInitMsgint0:购车团报名,1:三人行必须
APP应用IDappKeyString 非必须
来源渠道IDchIdString 非必须
设备IDdevIdString 非必须
车系IDcarSerialIdlongisInitMsg=1时为必须必须

2.3.3 团购活动详情页

mrobot测试接口： http://v36.pcauto.com.cn/buy/price/activityDetail/{id}?areaId=1&modelId=0&modelId=0&name=text&tel=13455455545&dId=364171E5-73FE-4907-9C3F-F5D47B355F2F&origin=${origin}

（QA阶段使用此接口，QA通过换回线上接口。）


请求URI：  http://mrobot.pcauto.com.cn/buy/price/activityDetail/{id}?areaId=1&modelId=0&modelId=0&name=text&tel=13455455545&dId=364171E5-73FE-4907-9C3F-F5D47B355F2F&origin=${origin}
示例： http://mrobot.pcauto.com.cn/buy/price/activityDetail/347?areaId=3&modelId=0&name=text&tel=13455455545&dId=C592AA63-9758-4594-B161-2B5780F89F40&origin=1
HTTP请求方式：GET
返回格式：html
请求参数：

参数名类型必须说明
idnumberYES团购活动id
areaIdnumberYES城市id
modelIdnumberNO车型id，没有情况下传0
dIdstringYES设备id
namestringYES用户的名字
telstringYES用户的电话号码

跳转协议：
点击提交信息按钮协议：pcaction://tuan-detail-click-result?name=xx&tel=xx&code=xxx

name：用户的姓名
tel：用户的电话号码
code：提交后返回的状态码

code的规则：
200 - 报名成功
204 - 表单必填参数不完整
205 - 活动结束，不能报名
206 - 活动未审核，不能报名
207 - 活动审核失败，不能报名
500 - 系统错误

2.4 询底价|我要优惠

2.4.1 询底价

备注：接口已上线
说明：此接口是在前版本的基础上新增了几个请求参数，分别是name、tel、isMain、v
Mrobot请求URL：  http://mrobot.pcauto.com.cn/buy/price/askprice?v=1.1.0&serialId={车系id}&modelId={车型id}&modelName={车系名+车型名}&areaId={城市id}&dealerId={经销商id}
示例： http://mrobot.pcauto.com.cn/buy/price/askprice?v=1.1.0&serialId=4313&modelId=30499&modelName=%E5%A5%A5%E8%BF%AAA6L%202014%E6%AC%BE%202.0%20TFSI%20%E6%89%8B%E5%8A%A8%E5%9F%BA%E6%9C%AC%E5%9E%8B&areaId=3&dealerId=0&isMain=1 HTTP请求方式：get
是否需要登录：否
返回格式：html页面
缓存方式：无
缓存时间：无
请求参数

参数名类型必须说明
serialIdstring是车系id
modelIdstring是车型id
modelNamestring是车系名称+车型名称
areaIdstring是城市id
dealerIdstring是经销商id，由车系综述页进入询底价页时，取0；由车型综述页中的经销商列表进入询底价页时，取对应的经销商id值
namestring否询价者姓名，不为空时“询底价页”的姓名一栏会填入该值
telstring否询价者手机号，不为空时“询底价页”的手机号一栏会填入该值
appKeystring否应用id，即应用的魔方key
chIdstring否来源渠道id，如应用在苹果商店下载安装的，取值为"app_store"
devIdstring否设备id
refererstring否来源url，详见附件《汽车报价宝典线索入口来源对应参数表（重要）.txt》
isMainstring否是否需要提供车型选择的跳转协议，0：不需提供，1：需提供，跳转协议为：pcaction://choose-car/。注：只有当dealerId为0时该参数有效
vstring是接口版本，固定取值"1.1.0"

补充说明： 1.当从车系综述页进入询底价页时，经销商已选择的个数超过选择上限（3个）的跳转协议为：pcaction://showtip/，可用于触发APP端的提示；[[BR]]

2.html页中带有javascript方法 function setCar(modelId,modelName)，可用于修改询底价页在切换车型后的车型信息更改；

页面内协议说明：

协议串说明
pcaction://choose-car/车型选择
pcaction://showtip/经销商的选择个数超过上限，APP的提示文案为"最多选择3个经销商"（注：协议串不带文案信息）

2.4.2 我要优惠

备注：接口已上线
说明：此接口是在前版本的基础上新增了几个请求参数，分别是name、tel、v
Mrobot请求URL：  http://mrobot.pcauto.com.cn/buy/price/getPromotion?v=1.1.0&serialId={车系id}&modelId={车型id}&modelName={车系名+车型名}&areaId={城市id}&dealerId={经销商id}
示例： http://mrobot.pcauto.com.cn/buy/price/getPromotion?v=1.1.0&modelId=20062&modelName=%E5%A5%A5%E8%BF%AAA6L%202012%E6%AC%BE%202.5%2030FSI%20%E6%8A%80%E6%9C%AF%E5%9E%8B&serialId=4313&areaId=1&dealerId=65469&name=tt&tel=13588888888&appKey=34ca62060a1474350000052f&chId=app_store&devId=cb2039424107a8f6d3847fd390d81e60ba7ab516&referer=sg_discount HTTP请求方式：get
是否需要登录：否
返回格式：html页面
缓存方式：无
缓存时间：无
请求参数

参数名类型必须说明
serialIdstring是车系id
modelIdstring是车型id
modelNamestring是车系名称+车型名称
areaIdstring是城市id
dealerIdstring是经销商id
namestring否询价者姓名，不为空时“我要优惠”页的姓名一栏会填入该值
telstring否询价者手机号，不为空时“我要优惠”页的手机号一栏会填入该值
appKeystring否应用id，即应用的魔方key
chIdstring否来源渠道id，如应用在苹果商店下载安装的，取值为"app_store"
devIdstring否设备id
refererstring否来源url，详见附件《汽车报价宝典线索入口来源对应参数表（重要）.txt》
vstring是接口版本，固定取值"1.1.0"

2.5 车系

2.5.1.车系-综述

备注：接口已上线
说明：此接口是在前版本的基础上新增了请求参数v
请求URL：  http://mrobot.pcauto.com.cn/buy/price/serial/{id}?v=1.1.0&areaId={cityid}&isSubscribed={1、0}&modelIds={1，2，3}
例子： http://mrobot.pcauto.com.cn/buy/price/serial/4313?v=1.1.0&areaId=3&isSubscribed=0&modelIds=
HTTP请求方式：get
是否需要登录：否
返回格式：html页面
缓存方式：无
缓存时间：无
请求参数

参数名类型必须说明
seriesidstring是车系id
isSubscribedstring是是否已经订阅了车系，取值0、1
modelIdsstring是本地已经加入对比的车型id列表，逗号隔开
vstring是接口版本，固定取值"1.1.0"

页面内数据说明：在返回的页面里添加了注释数据/*@_HTML_META_START_（数据部分）_HTML_META_END_@*/
数据内容为： 

{
    "kind": "中大型车",
    "photo": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1410/28/c2/40229017_40229017_1414462821712_120x90.jpg",
    "priceRange": "38.30~74.26万",
    "cars":[
        {
            "data": [
                {
                    "config": "6挡手动 前置前驱 车身稳定控制 天窗",
                    "dealerName": "上海晨安奥迪",
                    "dealerPhone": "400-860-3273",
                    "discount": "8.63",
                    "id": "30499",
                    "is400": 1,
                    "isNews": "0",
                    "minPrice": "29.67",
                    "photo": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1208/21/c7/13077074_13077074_1345530200671_120x90.jpg",
                    "price": "38.3",
                    "state": "在售",
                    "status": "在售",
                    "title": "2014款 2.0 TFSI 手动基本型",
                    "vendorPrice": "31.02~38.30"
                },
            "title": " 2.0T 涡轮增压 180马力"
        },
        ....
    ]
}

数据字段说明： 1.kind、photo、priceRange，可用于 从热搜进入车系页再进行“订阅”时的数据保存，以免跳转到“我的订阅”时出现相关信息无法显示的问题； 2.cars，用于从针对车系的“询底价”按钮 进入“询底价页”，页面的“意向车型”的车型列表数据；

2.5.2.车系-优惠

 http://trac.pc.com.cn/iphone/wiki/pcauto_BuyAuto_1.1.0#a2.2.1.优惠-优惠列表

2.6 车型

2.6.1.车型-综述

备注：接口已上线
说明：此接口是在前版本的基础上新增了请求参数v
请求URL：  http://mrobot.pcauto.com.cn/buy/price/models/{id}?v=1.1.0&areaId=1&isCompared=0&isSubscribed=0
例子： http://mrobot.pcauto.com.cn/buy/price/models/30499?v=1.1.0&areaId=1&isCompared=0&isSubscribed=0
HTTP请求方式：get
是否需要登录：否
返回格式：html页面
缓存方式：无
缓存时间：无
请求参数

参数名类型必须说明
idstring是车型id
areaIdstring是城市id
isComparedstring是是否本地已经添加对比，取值0、1
isSubscribedstring是是否本地已经添加订阅，取值0、1
vstring是接口版本，固定取值"1.1.0"

页面内协议说明

协议串说明

Attachments