pcauto_BuyAuto_1.1.0 – iphone

wiki:pcauto_BuyAuto_1.1.0

Context Navigation

Version 27 (modified by oujianqiang, 11 years ago) (diff)
--

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&list=true&jb=72&pageSize=20&pageNo=1
后端请求测试URL：
后端请求正式URL：
HTTP请求方式：get
是否需要登录：否
返回格式：json
缓存方式：无
缓存时间：无
请求参数：无

参数名	类型	必须	说明
rid	string	是	用户所在地区id
list	string	是	筛选个数、筛选列表，取值true/false
ps	string	否	最小价格
pe	string	否	最大价格
jb	string	否	级别
pl	string	否	排量
bsx	string	否	变速箱
mkid	string	否	结构
country	string	否	国别
rl	string	否	燃料
zw	string	否	座位
qdfs	string	否	驱动
pz	string	否	配置
pageNo	string	否	分页
pageSize	string	否	分页大小
sortType	string	否	排序方式，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 团购活动列表

    (接口未上线，请连192.168.21.94:8888进行测试）
    请求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 发起团购

(接口未上线，请连192.168.21.94:8888进行测试）
    请求方式：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/"
    }
    注意: （关于referer值）购车APP填写固定值:http://mrobot.pcauto.com.cn/autobuy/   用于记录报名来源于购车app
           (关于carSerialId值）isInitMsg=1时为必须
    参数说明如下表：

参数名称参数名类型说明是否必须
经销商ID dealerId Long 默认0 必须
网友姓名 userName String 必须
网友城市 regionId Long 必须
网友电话 phone String 必须
来源URL referer String 见注意必须
平台来源 origin int 0未知,1:web,2:wap,3:IOS,4:Android,5:WP,6:杂志必须
是否三人行 isInitMsg int 0:购车团报名,1:三人行必须
APP应用ID appKey String 非必须
来源渠道ID chId String 非必须
设备ID devId String 非必须
车系ID carSerialId long isInitMsg=1时为必须必须

2.3.3 团购活动详情页

原接口：http://mrobot.pcauto.com.cn/v3/price/activityDetail/

2.4 询底价|我要优惠

2.4.1 询底价

备注：
Mrobot请求URL： http://mrobot.pcauto.com.cn/buy/price/askprice?serialId={车系id}&modelId={车型id}&modelName={车系名+车型名}&areaId={城市id}&dealerId={经销商id}
示例： http://mrobot.pcauto.com.cn/buy/price/askprice?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 HTTP请求方式：get
是否需要登录：否
返回格式：html页面
缓存方式：无
缓存时间：无
请求参数

参数名	类型	必须	说明
serialId	string	是	车系id
modelId	string	是	车型id
modelName	string	是	车系名称+车型名称
areaId	string	是	城市id
dealerId	string	是	经销商id，由车系综述页进入询底价页时，取0；由车型综述页中的经销商列表进入询底价页时，取对应的经销商id值
name	string	否	询价者姓名，不为空时“询底价页”的姓名一栏会填入该值
tel	string	否	询价者手机号，不为空时“询底价页”的手机号一栏会填入该值
appKey	string	否	应用id，即应用的魔方key
chId	string	否	来源渠道id，如应用在苹果商店下载安装的，取值为"app_store"
devId	string	否	设备id
referer	string	否	来源url，详见附件《汽车报价宝典线索入口来源对应参数表（重要）.txt》
isMain	string	否	是否需要提供车型选择的跳转协议，0：不需提供，1：需提供，跳转协议为：pcaction://choose-car/。注：只有当dealerId为0时该参数有效

补充说明：当从车系综述页进入询底价页时，经销商已选择的个数超过选择上限（3个）的跳转协议为：pcaction://showtip/

2.4.2 我要优惠

备注：
Mrobot请求URL： http://mrobot.pcauto.com.cn/buy/price/getPromotion?serialId={车系id}&modelId={车型id}&modelName={车系名+车型名}&areaId={城市id}&dealerId={经销商id}
示例： http://mrobot.pcauto.com.cn/buy/price/getPromotion?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页面
缓存方式：无
缓存时间：无
请求参数

参数名	类型	必须	说明
serialId	string	是	车系id
modelId	string	是	车型id
modelName	string	是	车系名称+车型名称
areaId	string	是	城市id
dealerId	string	是	经销商id
name	string	否	询价者姓名，不为空时“我要优惠”页的姓名一栏会填入该值
tel	string	否	询价者手机号，不为空时“我要优惠”页的手机号一栏会填入该值
appKey	string	否	应用id，即应用的魔方key
chId	string	否	来源渠道id，如应用在苹果商店下载安装的，取值为"app_store"
devId	string	否	设备id
referer	string	否	来源url，详见附件《汽车报价宝典线索入口来源对应参数表（重要）.txt》

Attachments

汽车报价宝典线索入口来源对应参数表（重要）.txt (324 bytes) - added by oujianqiang 11 years ago. 汽车报价宝典线索入口来源对应参数表（重要）

Download in other formats:

Plain Text

参数名称	参数名	类型	说明	是否必须
经销商ID	dealerId	Long	默认0	必须
网友姓名	userName	String		必须
网友城市	regionId	Long		必须
网友电话	phone	String		必须
来源URL	referer	String	见注意	必须
平台来源	origin	int	0未知,1:web,2:wap,3:IOS,4:Android,5:WP,6:杂志	必须
是否三人行	isInitMsg	int	0:购车团报名,1:三人行	必须
APP应用ID	appKey	String		非必须
来源渠道ID	chId	String		非必须
设备ID	devId	String		非必须
车系ID	carSerialId	long	isInitMsg=1时为必须	必须