wiki:pcauto_BuyAuto_1.1.0

Version 74 (modified by caozhaoyuan, 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.车型-综述
    7. 2.7 我的
      1. 2.7.3. 我的-团购列表

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： http://mrobot.pcauto.com.cn/buy/price/search?rid=1&pageSize=20&pageNo=1&list=true&ps=0&sortType=1
后端请求测试URL：  http://price.pcauto.com.cn/interface/iphone/query_car.jsp?rid=1&pageSize=20&pageNo=1&list=true&ps=0
后端请求正式URL：  http://dev3.pcauto.com.cn:8001/interface/iphone/query_car.jsp?rid=1&pageSize=20&pageNo=1&list=true&ps=0&sort=1&asc=true
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

后端请求中参数sort=0表按热度，sort=1表按价格，desc只针对sort=1时有效，desc=true表降，false表升

2.2 优惠

2.2.1. 优惠-优惠列表

(接口已上线）
说明：此接口与前版本区别在于，在返回结果的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://mrobot.pcauto.com.cn/buy/price/activityListv11?pageNo=1&pageSize=1&regionId=3
    应用端接口：http://mall.pcauto.com.cn/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 发起团购

    备注：接口已上线，提交的信息会影响到线上，QA阶段慎用或请连测试服务器
    （QA测试连代理把mrobot.pcauto.com.cn重定向到v36.pcauto.com.cn）
    请求方式：POST
    请求mrobot接口：http://mrobot.pcauto.com.cn/v3/search/mallPost
    应用端接口：http://mall.pcauto.com.cn/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 - 活动审核失败，不能报名
208 - 报名已成功提交
500 - 系统错误
    注意: （关于referer值）购车APP填写固定值:http://mrobot.pcauto.com.cn/autobuy/   用于记录报名来源于购车app
           (关于carSerialId值）isInitMsg=1时为必须
    参数说明如下表：
参数名称参数名类型说明是否必须
经销商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 团购活动详情页

注意：web端活动报名成功后，要同步给微信推送平台的接口，所以请求活动详情页时，必须传设备id（dId参数）
备注：接口已上线，页面的“活动报名”所提交信息会影响到线上，QA阶段慎用或请连测试服务器

（QA测试连代理把mrobot.pcauto.com.cn重定向到v36.pcauto.com.cn）


请求URI：  http://mrobot.pcauto.com.cn/buy/price/activityDetailv11/{id}?areaId=1&serialId=0&modelId=0&name=text&tel=13455455545&dId=364171E5-73FE-4907-9C3F-F5D47B355F2F&origin=${origin}
示例： http://mrobot.pcauto.com.cn/buy/price/activityDetailv11/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；否则在serialId有效（有效：是指能在该活动中找到该车系）时，详情页的车型选项会默认选中改车型id对应的车型。产品需求：从车型综述页的“去团购”去“活动详情页”必须传serialId和modelId
serialIdnumberNO车系id，没有情况下传0；否则详情页的车系选项会默认选中该车系id对应的车系。产品需求：从车系综述页的“去团购”去“活动详情页”必须传serialId
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"

页面内协议说明

协议串说明

2.7 我的

2.7.3. 我的-团购列表


说明:以往是直接调用后端应用接口 http://wxzs.pcauto.com.cn/interface/app/get_autobuyOrder.jsp 来获取数据的，现在通过mrobot封装一层，以增加接口变更的灵活性。
mrobot接口 :  http://mrobot.pcauto.com.cn/buy/groupon/getAutobuyOrder
后端测试url :  http://v12.pcauto.com.cn:8004/interface/app/get_autobuyOrder.jsp
后端正式url : http://wxzs.pcauto.com.cn/interface/app/get_autobuyOrder.jsp
参数描述:
@param callback 回调函数名,选填
@param m 调用的方法,必填，取值=getOrderList : 获取我的团购报名列表
@param dId 设备ID,必填
@param bt 报名-起始时间, 选填 格式为:yyyy-MM-dd 例:2014-08-11
@param et 报名-结束时间, 选填 格式为:yyyy-MM-dd 例:2014-08-11
@param page 分页,当前页数, 选填
@param size 分页,页面长度, 选填 

@return json 例:
{　
　"data": [
　　{
　　　"acId": 191, ##团购活动id
　　　"deadline": "2014-08-06", ##活动截至时间
　　　"discount": 0.20, ##优惠
　　　"discountPrice": 11.07, ##优惠价
　　　"image": " http://img.pconline.com.cn/images/upload/upc/tx/auto5/1406/25/c5/35654388_1403678285814_350x260.jpg", ##图像
　　　"orderCount": 3, ##报名人数
　　　"sgId": 8670, ##车系id
　　　"sgName": "奥迪Q3", ##车系名
　　　"title": "奥迪A4L 2013款 2.0 40TFSI quattro" ##活动标题
　　},{
　　　...其他团购信息
　　}]
}

Attachments