| | 1 | [[TOC]] |
| | 2 | |
| | 3 | == 1.基本约定 == |
| | 4 | mrobot开发机代理:192.168.10.199 端口为 1080 |
| | 5 | [[BR]]mrobot测试机代理:192.168.10.198 端口为 1080 |
| | 6 | |
| | 7 | == 2.接口列表 == |
| | 8 | === 2.1 [=#point2.1 获取全国所有城市接口] === |
| | 9 | (开发已完成,测试请连开发机代理) |
| | 10 | {{{ |
| | 11 | 请求url:http://mrobot.pcauto.com.cn/xsp/x/192.168.33.60:8081/interface/app/jsonArea.jsp |
| | 12 | HTTP请求方式:GET |
| | 13 | 是否需要登录:否 |
| | 14 | 返回格式:json |
| | 15 | 缓存方式:无 |
| | 16 | 缓存时间:无 |
| | 17 | 请求参数: |
| | 18 | 无 |
| | 19 | |
| | 20 | 返回结果: |
| | 21 | { |
| | 22 | "code": 0或-1 (0成功,-1失败) |
| | 23 | "message":提示信息 |
| | 24 | "addressList": [ |
| | 25 | { |
| | 26 | “citypy":"A" (字母) |
| | 27 | "cityId": 城市编号, |
| | 28 | "city": “鞍山市”, |
| | 29 | “type” : “2” |
| | 30 | }, |
| | 31 | { |
| | 32 | "citypy":"C" |
| | 33 | "cityId": 1, |
| | 34 | "city": “北京市", |
| | 35 | “type” : “1” |
| | 36 | } |
| | 37 | ] |
| | 38 | } |
| | 39 | |
| | 40 | }}} |
| | 41 | |
| | 42 | === 2.2 [=#point2.2 违章查询] === |
| | 43 | ==== 2.2.1 [=#point2.2.1 查询首页] ==== |
| | 44 | (开发已完成,测试请连开发机代理) |
| | 45 | {{{ |
| | 46 | 请求url:http://mrobot.pcauto.com.cn/xsp/s/auto/info/v4.7/illegalQueryv47.xsp |
| | 47 | HTTP请求方式:GET |
| | 48 | 是否需要登录:false |
| | 49 | 返回格式:HTML页面 |
| | 50 | 缓存方式:无 |
| | 51 | 缓存时间:没有 |
| | 52 | 请求参数:无 |
| | 53 | 返回结果:HTML |
| | 54 | 点击提交返回协议pcaction://webview_searchInf/?regionStr=%E5%8E%A6%E9%97%A8&abbrStr=%E7%B2%A4&numStr=AEOC07&engineStr=AS1234&vinStr=DF0987&telStr=15813374371&yearStr=2010&monthStr=10 |
| | 55 | HTTP请求方式:GET |
| | 56 | }}} |
| | 57 | 协议参数说明: |
| | 58 | ||参数名||类型||必须||说明|| |
| | 59 | ||regionStr||String||Y||查询地区|| |
| | 60 | ||abbrStr||String||Y||车牌所在的省份|| |
| | 61 | ||numStr||String||N||车牌号|| |
| | 62 | ||engineStr||String||N||发动机号|| |
| | 63 | ||vinStr||String||N||车架号|| |
| | 64 | ||telStr||String||N||电话|| |
| | 65 | ||yearStr||String||N||年|| |
| | 66 | ||monthStr||String||N||月|| |
| | 67 | |
| | 68 | ==== 2.2.2 [=#point2.2.2 查询结果页(显示详情或查询错误页)] ==== |
| | 69 | (开发已完成,测试请连开发机代理) |
| | 70 | {{{ |
| | 71 | 输入车辆信息正确、匹配 |
| | 72 | 请求url:http://mrobot.pcauto.com.cn/v3/pingan/illegalInf?shopSign=%E6%B2%AAK79018&voitureNo=&engineNo=006496&carType=01 |
| | 73 | HTTP请求方式:GET |
| | 74 | 是否需要登录:false |
| | 75 | 返回格式:HTML页面 |
| | 76 | 缓存方式:接口缓存 |
| | 77 | 缓存时间:10min |
| | 78 | 返回结果:HTML |
| | 79 | |
| | 80 | 输入信息不匹配,车辆信息错误的时候 |
| | 81 | 请求url:http://mrobot.pcauto.com.cn/v3/pingan/illegalInf?shopSign=%E6%B2%AAK79018&voitureNo=&engineNo=006496&carType=01 |
| | 82 | HTTP请求方式:GET |
| | 83 | 是否需要登录:false |
| | 84 | 返回格式:HTML页面 |
| | 85 | 缓存方式:接口缓存 |
| | 86 | 缓存时间:10min |
| | 87 | 返回结果: |
| | 88 | {"code": -1,"msg": "车辆信息错误"} |
| | 89 | |
| | 90 | }}} |
| | 91 | 请求参数: |
| | 92 | ||参数名||类型||必须||说明|| |
| | 93 | ||shopSign||String||Y||车牌号码|| |
| | 94 | ||carType||String||Y||车牌类别|| |
| | 95 | ||voitureNo||String||N||车架号|| |
| | 96 | ||engineNo||String||N||发动机号|| |
| | 97 | ||province||String||N||省份|| |
| | 98 | ||cityName||String||N||城市名|| |
| | 99 | ||user_mobile||String||N||手机号码|| |
| | 100 | ||buydate||String||N||购买日期|| |
| | 101 | ||insuranceExpired ||String||N||保险到期日 || |
| | 102 | ||carSeries||String||N||车系|| |
| | 103 | ||buyprice ||String||N||购买价格|| |
| | 104 | ||carMaker ||String||N||购车品牌 || |
| | 105 | ||carModel||String||N||车型|| |
| | 106 | ||miles||String||N||行驶里数|| |
| | 107 | ||other ||String||N||其他参数 || |