Changes between Initial Version and Version 1 of interface/pcauto_BuyAuto_1.5.0


Ignore:
Timestamp:
12/28/2015 02:30:31 PM (10 years ago)
Author:
xushengde
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • interface/pcauto_BuyAuto_1.5.0

    v1 v1  
     1[[TOC]] 
     2 
     3=报价1.5.0接口文档 = 
     4>mrobot代理环境说明:  
     5     192.168.10.198 端口为 1080 连的是QA测试环境(192.168.74.80)[[BR]]  
     6     192.168.10.199 端口为 1080 连的是dev40的开发环境(192.168.75.40)[[BR]]  
     7     '''ps:对于mrobot.pcauto.com.cn/x/前缀的接口,mrobot仅作代理,没有任何逻辑处理。''' [[BR]]  
     8     
     9---------- 
     10=== 1.1找车页附近经销商接口 === 
     11[[BR]] 
     12 
     13 
     14**说明** 
     15 
     16> 返回首附近经销商数据 
     17 
     18**缓存时间** 
     19 
     20>0 
     21 
     22**提交方式** 
     23 
     24> GET 
     25 
     26**是否登录** 
     27 
     28> 否 
     29 
     30**数据来源** 
     31 
     32 
     33**请求参数**= 
     34||= 城市id =||= 品牌id =||= 经度 =||=维度 =|| 
     35**返回** 
     36{{{#!java 
     37{ 
     38     "status": 0, 
     39"message": "操作成功", 
     40    "datas": [ 
     41        { 
     42           经销商id          int 
     43         经销商名称         String  
     44         经销商简称         String 
     45        经销商类型          int  
     46         距离               float/double 
     47         车身图片           String 
     48         主营品牌                    
     49        }, 
     50    ], 
     51} 
     52}}} 
     53 
     54 
     55---------- 
     56 
     57=== 1.2经销商主页 === 
     58[[BR]] 
     59 需要后端提供web的url 
     60**请求参数** 
     61||=  经销商id =|| 
     62 
     63需要拨打电话的协议 
     64   点击进入在售车系的协议 
     65   点击进入促销优惠的协议 
     66   点击进入预约试驾的协议 
     67   点击地图的协议       
     68   点击在售车系的协议 
     69 
     70=== 1.3经销商简介 === 
     71需要后端提供web的url 
     72**请求参数** 
     73||=  经销商id =|| 
     74 
     75 
     76=== 1.4预约试驾 === 
     77参考询底价做法(已确认)  
     78现有询底价url: 
     79http://mrobot.pcauto.com.cn/buy/price/askprice?v=1.1.0&serialId={车系 id}&modelId={车型id}&modelName={车系名+车型名}&areaId={城市id}&dealerId={经销商id} 
     80 
     81=== 1.5促销优惠 === 
     82 
     83 
     84**请求参数** 
     85||= 经销商id =|| 
     86**返回** 
     87{{{#!java 
     88{ 
     89    "status": 0, 
     90"message": "操作成功", 
     91Page 
     92pageSize 
     93    "datas": [ 
     94        { 
     95          促销详情id   
     96          促销Title 
     97          促销时间 
     98        }, 
     99], 
     100} 
     101}}} 
     102 
     103 
     104=== 1.6促销详情 === 
     105 
     106 促销详情url链接  
     107**请求参数** 
     108||= 促销详情id =|| 
     109 
     110需要协议: 
     111  400电话协议 
     112  跳转我要优惠协议 
     113  跳转优惠详情协议 
     114 
     115 
     116 
     117 
     118 
     119=== 1.7在售车系 === 
     120 
     121**请求参数** 
     122||= 城市id =||= 车系id =||= 经销商id =||= 区域id =|| 
     123 
     124**返回** 
     125{{{#!java 
     126{ 
     127"status": 0, 
     128"message": "操作成功", 
     129Page 
     130pageSize 
     131车系名称: 
     132官方价: 
     133data:[ 
     134{ 
     135描述  (原型上的 2.0T ) 
     136车型id 
     137                车型名 
     138                价格 
     139                官方价 
     140                下降 
     141                  
     142}, 
     143 ] 
     144 
     145} 
     146}}} 
     147 
     148 
     149=== 1.8销量排行榜 === 
     150原接口:http://mrobot.pcauto.com.cn/xsp/s/auto/buy/v1.4/hotSellSerials.xsp?year=2015&month=1&type=73   
     151 
     152**请求参数**=(首次请求不需要添加参数) 
     153||= 年份 =||= 月份 =||= 经销商 =||= 区域 =|| 
     154 
     155=== 2.1优惠全部 === 
     156 
     157**请求参数**=(首次请求不需要添加参数) 
     158||= 区域id =||=品牌id=||= 车系id =||= 车型id =|| 
     159其中品牌id、车系id、车型id只选其中之一传参,代表不同的列表获取不同的数据 
     160 
     161**返回** 
     162{{{#!java 
     163{ 
     164 total: 143,                    //团购总数 
     165 pageCount: 15,         //团购总页数 
     166 pageNo: 1,                     //第几页 
     167 pageSize: 10,          //每页大小 
     168 Type           //排序的规则类型 
     169 品牌名、车系名、车型名(根据传参返回对应的名称) 
     170 datas:[ 
     171{ 
     172车系id or 车型id(如果穿的是品牌id,这里是车系id,如果参数传的的车系或者车型id,这里是车型id) 
     173车系名称 or 车型名称(如果穿的是品牌id,这里显示车型名称,如果参数传的是车系或者车型id,这里是车型名称) 
     174总数(查看更多优惠的总数,如果参数传的是车型id,这里可以不要) 
     175 
     176 
     177“carmodel”: 
     178 
     179modelId: 7616,                  //车型id 
     180  price: 7.78,                  // 车型官方价 
     181  name: "锐欧 2007款 1.4 手动 豪华型",  //车型名称 
     182  discountPrice: 5.78,  //促销价 
     183  discount : 20000,                     //降幅 
     184  giftPackage : "送10000元礼包",    //礼包优惠 
     185  modelType : "现车充足",           //现车情况 
     186                }, 
     187                        “dealer”: 
     188                        { 
     189                           dealerId : 32046,            // 经销商ID 
     190                                           name : 庞大东风悦达起亚,     // 经销商简称  
     191                           price : 7.78,                        //车型官方价 
     192                           discountPrice: 5.78, //行情促销价 
     193                           discount : 20000,                    //降幅 
     194                           dealerPrice : 7.78,          // 经销商报价 
     195                           is4S : 1,            // 是否4S店,1:是,0:否 
     196                           is400 : 1,   // 是否400电话,1:是,0:否 
     197                           phone : 400-670-5680,        //电话 
     198                           namelistRange : 1                    // 销售范围,0:本市,1:本省,2:全国 
     199 
     200                        } 
     201 
     202} 
     203 
     204 
     205} 
     206 
     207], 
     208} 
     209}}} 
     210 
     211=== 2.2车系优惠列表,根据接口制作改样式 === 
     212 
     213=== 2.3车型优惠列表,根据接口制作改样式 === 
     214 
     215=== 2.4车系-综述-优惠列表,根据接口制作改样式 === 
     216 
     217 
     218 
     219 
     220=== 3.1 图片列表 === 
     221接口改用和资讯一样的接口 
     222 
     223=== 3.2车系年份排序 === 
     224待产品确认规则 
     225 
     226=== 3.3经销商远近排序 === 
     227待页面加载完成之后,由app主动调用js方法或者由js调用app方法获取经纬度 
     228 
     229 
     230 
     231 
     232 
     233 
     234 
     235 
     236 
     237 
     238