| | 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: |
| | 79 | http://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": "操作成功", |
| | 91 | Page |
| | 92 | pageSize |
| | 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": "操作成功", |
| | 129 | Page |
| | 130 | pageSize |
| | 131 | 车系名称: |
| | 132 | 官方价: |
| | 133 | data:[ |
| | 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 | { |
| | 179 | modelId: 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 | |