Changes between Version 5 and Version 6 of pcauto_BuyAuto_1.1.0

Timestamp:

11/26/2014 10:37:13 AM (11 years ago)

Author:

oujianqiang

Comment:

--

pcauto_BuyAuto_1.1.0

@@ +1 @@
+[[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. 筛选-快速查找符合条件个数/列表====
+说明：此接口是在前版本的基础上新增了sortType的请求参数，指示返回结果的排序方式
+备注：筛选条件变后，自动获取符合筛选条件的车型个数 
+[[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： http://v17.pcauto.com.cn:8002/interface/iphone/query_car.jsp
+[[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. 优惠-优惠列表 ====
+说明：此接口与前版本区别在于返回结果新增了几个字段，分别是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]]
+[[BR]]后端请求测试环境URL：
+[[BR]]http://dev3.pcauto.com.cn:8001/dealer/interface/app/market_groupby_model_json.jsp?pageNo=1&pageSize=10&areaId=3[[BR]]
+[[BR]]HTTP请求方式：get 
+[[BR]]返回格式：json
+[[BR]]请求参数
+{{{
+areaId：城市id [[BR]]
+mfId: 厂商id [[BR]]
+sgId: 车系id [[BR]]
+modelId：车型id [[BR]]
+pageNo：第几页 [[BR]]
+pageSize：每页大小 [[BR]]
+callback：js回调函数名称 [[BR]]
+}}}
+返回结果
+{{{
+{
+ 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 团购活动列表] ====