[[TOC]]

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

[[BR]]Mrobot请求URL： http://mrobot.pcauto.com.cn/buy/price/search?rid=1&list=true&jb=72&pageSize=20&pageNo=1
[[BR]]后端请求测试URL： 
[[BR]]后端请求正式URL： 
[[BR]]HTTP请求方式：get
[[BR]]是否需要登录：否
[[BR]]返回格式：json
[[BR]]缓存方式：无
[[BR]]缓存时间：无
[[BR]]请求参数：无
||参数名||类型||必须||说明||
||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进行测试）
[[BR]]说明：此接口与前版本区别在于，在返回结果的models成员元素中新增了几个字段，分别是giftPackage（礼包优惠），modelType（现车情况）
[[BR]]Mrobot请求URL：http://mrobot.pcauto.com.cn/buy/price/promotionList?areaId=1&pageSize=20&pageNo=1 
[[BR]]后端请求正式环境URL：http://price.pcauto.com.cn/dealer/interface/app/market_groupby_model_json.jsp
[[BR]]后端请求测试环境URL：[[BR]]http://dev3.pcauto.com.cn:8001/dealer/interface/app/market_groupby_model_json.jsp?pageNo=1&pageSize=10&areaId=3
[[BR]]HTTP请求方式：get 
[[BR]]返回格式：json
[[BR]]请求参数
{{{
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 [=#point2.3 团购活动] ===
==== 2.3.1 [=#point2.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 [=#point2.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 [=#point2.3.3 团购活动详情页] ====
{{{
原接口：http://mrobot.pcauto.com.cn/v3/price/activityDetail/
}}}



=== 2.4 询底价|我要优惠 ===
==== 2.4.1 询底价 ====
备注：接口未上线，请连 192.168.22.145:8888 进行测试
[[BR]]说明：此接口是在前版本的基础上新增了三个请求参数，分别是name、tel、isMain
[[BR]]Mrobot请求URL： http://mrobot.pcauto.com.cn/buy/price/askprice?serialId={车系id}&modelId={车型id}&modelName={车系名+车型名}&areaId={城市id}&dealerId={经销商id}
[[BR]]示例：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[[BR]]
是否需要登录：否[[BR]]
返回格式：html页面[[BR]]
缓存方式：无[[BR]]
缓存时间：无[[BR]]
请求参数[[BR]]
||参数名||类型||必须||说明||
||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 我要优惠 ====
备注：接口未上线，请连 192.168.22.145:8888 进行测试
[[BR]]说明：此接口是在前版本的基础上新增了两个请求参数，分别是name、tel
[[BR]]Mrobot请求URL： http://mrobot.pcauto.com.cn/buy/price/getPromotion?serialId={车系id}&modelId={车型id}&modelName={车系名+车型名}&areaId={城市id}&dealerId={经销商id}
[[BR]]示例：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[[BR]]
是否需要登录：否[[BR]]
返回格式：html页面[[BR]]
缓存方式：无[[BR]]
缓存时间：无[[BR]]
请求参数[[BR]]
||参数名||类型||必须||说明||
||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》||