VIN码车辆查询
<h3>接口描述</h3>
<ul>
<li>传入车架号，返回车辆信息</li>
</ul>
<h3>请求地址</h3>
<p><code>https://api.jumdata.com/vehicle/vin-query</code></p>
<h3>请求方式</h3>
<ul>
<li>GET/POST</li>
</ul>
<h3>请求格式</h3>
<ul>
<li>x-www-form-urlencoded</li>
</ul>
<h3>请求参数</h3>
<table>
<thead>
<tr>
<th>名称</th>
<th>类型</th>
<th>必须</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>appId</td>
<td>String</td>
<td>是</td>
<td>服务商分配的唯一标识</td>
</tr>
<tr>
<td>timestamp</td>
<td>Long</td>
<td>是</td>
<td>当前时间的毫秒数</td>
</tr>
<tr>
<td>sign</td>
<td>String</td>
<td>是</td>
<td>签名， 详见签名算法说明</td>
</tr>
<tr>
<td>vin</td>
<td>String</td>
<td>是</td>
<td>车架号</td>
</tr>
</tbody>
</table>
<h3>签名算法</h3>
<pre><code>sign = sha256(appId + appSecret + timestamp)</code></pre>
<p>用服务商分配的 <strong>appId</strong>、服务商分配的 <strong>appSecret</strong>，当前时间毫秒数 <strong>timestamp</strong>，按上述顺序拼接成字符串，再进行 <strong>sha256</strong> 哈希得到。如下：</p>
<pre><code class="language-java">String appId = &quot;xyzxy2121zxyz&quot;；
String timestamp = &quot;1555378976238&quot;；
String appSecret = &quot;efcefcef1121cefcefc1212121&quot;；
String str = appId + appSecret + timestamp；
String sign = sha256(str)；</code></pre>
<h4>正确返回样例</h4>
<pre><code>{
&quot;code&quot;: 200,
&quot;msg&quot;: &quot;成功&quot;,
&quot;taskNo&quot;: &quot;074388502348792558&quot;,
&quot;data&quot;: {
&quot;fueltype&quot;: &quot;汽油&quot;,
&quot;frontbraketype&quot;: &quot;盘式&quot;,
&quot;bodystructure&quot;: null,
&quot;fuelgrade&quot;: &quot;92号&quot;,
&quot;carid&quot;: 8416,
&quot;manufacturer&quot;: &quot;长安凯程&quot;,
&quot;comfuelconsumption&quot;: &quot;6.70&quot;,
&quot;gearnum&quot;: &quot;5&quot;,
&quot;machineoil&quot;: {
&quot;volume&quot;: &quot;2.8L&quot;,
&quot;viscosity&quot;: &quot;10W-40&quot;,
&quot;level&quot;: &quot;SN&quot;,
&quot;grade&quot;: &quot;矿物&quot;
},
&quot;len&quot;: &quot;3642&quot;,
&quot;engine&quot;: &quot;JL465QD&quot;,
&quot;maxhorsepower&quot;: &quot;82&quot;,
&quot;price&quot;: &quot;2.89万&quot;,
&quot;parkingbraketype&quot;: &quot;手拉式&quot;,
&quot;bodytype&quot;: &quot;两厢&quot;,
&quot;vin&quot;: &quot;LS4BDB3D9AF129278&quot;,
&quot;displacement&quot;: &quot;1.0L&quot;,
&quot;gearbox&quot;: &quot;5挡 手动&quot;,
&quot;fronttiresize&quot;: &quot;155 R13LT&quot;,
&quot;brand&quot;: &quot;长安凯程&quot;,
&quot;environmentalstandards&quot;: &quot;国三&quot;,
&quot;rearbraketype&quot;: &quot;鼓式&quot;,
&quot;height&quot;: &quot;1925&quot;,
&quot;drivemode&quot;: &quot;后轮驱动&quot;,
&quot;maxpower&quot;: &quot;50&quot;,
&quot;displacementml&quot;: &quot;1000&quot;,
&quot;iscorrect&quot;: 1,
&quot;weight&quot;: &quot;960&quot;,
&quot;reartiresize&quot;: &quot;165/70 R13LT&quot;,
&quot;chassis&quot;: null,
&quot;listdate&quot;: &quot;&quot;,
&quot;yeartype&quot;: &quot;2009&quot;,
&quot;sizetype&quot;: &quot;面包车&quot;,
&quot;seatnum&quot;: &quot;7&quot;,
&quot;wheelbase&quot;: &quot;2500&quot;,
&quot;name&quot;: &quot;长安凯程 长安之星 2009款 SC6363B3S&quot;,
&quot;geartype&quot;: &quot;手动&quot;,
&quot;width&quot;: &quot;1528&quot;,
&quot;carlist&quot;: [
{
&quot;name&quot;: &quot;长安轻型车 长安之星 2012款 1.0L 手动 SC6363B4Y 7座&quot;,
&quot;typeid&quot;: 650,
&quot;typename&quot;: &quot;长安之星&quot;,
&quot;carid&quot;: 8382
},
{
&quot;name&quot;: &quot;长安轻型车 长安之星 2012款 1.0L 手动 SC6363B4Y 8座&quot;,
&quot;typeid&quot;: 650,
&quot;typename&quot;: &quot;长安之星&quot;,
&quot;carid&quot;: 8384
},
{
&quot;name&quot;: &quot;长安轻型车 长安之星 2009款 SC6363B3S&quot;,
&quot;typeid&quot;: 650,
&quot;typename&quot;: &quot;长安之星&quot;,
&quot;carid&quot;: 8416
}
],
&quot;typename&quot;: &quot;长安之星&quot;
}
}</code></pre>
<h4>错误返回样例</h4>
<pre><code>{
&quot;msg&quot;: &quot;参数错误&quot;,
&quot;code&quot;: 400
}</code></pre>
<h3>返回字段说明</h3>
<table>
<thead>
<tr>
<th>名称</th>
<th>描述</th>
</tr>
</thead>
<tbody>
<tr>
<td>code</td>
<td>返回码，详见code返回码说明（非http返回状态码）</td>
</tr>
<tr>
<td>msg</td>
<td>code对应的描述</td>
</tr>
<tr>
<td>charge</td>
<td>计费标志</td>
</tr>
<tr>
<td>taskNo</td>
<td>本次请求号</td>
</tr>
<tr>
<td>data</td>
<td>车辆信息，详见data字段说明</td>
</tr>
</tbody>
</table>
<h4>data字段说明</h4>
<table>
<thead>
<tr>
<th>参数名称</th>
<th>类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>manufacturer</td>
<td>string</td>
<td>厂家名称</td>
</tr>
<tr>
<td>brand</td>
<td>string</td>
<td>品牌</td>
</tr>
<tr>
<td>cartype</td>
<td>string</td>
<td>车型</td>
</tr>
<tr>
<td>name</td>
<td>string</td>
<td>名称</td>
</tr>
<tr>
<td>yeartype</td>
<td>string</td>
<td>年款</td>
</tr>
<tr>
<td>environmentalstandards</td>
<td>string</td>
<td>排放标准</td>
</tr>
<tr>
<td>comfuelconsumption</td>
<td>string</td>
<td>油耗</td>
</tr>
<tr>
<td>engine</td>
<td>string</td>
<td>发动机</td>
</tr>
<tr>
<td>gearbox</td>
<td>string</td>
<td>变速箱</td>
</tr>
<tr>
<td>drivemode</td>
<td>string</td>
<td>驱动方式</td>
</tr>
<tr>
<td>carbody</td>
<td>string</td>
<td>车身形式</td>
</tr>
<tr>
<td>fronttiresize</td>
<td>string</td>
<td>前轮胎尺寸</td>
</tr>
<tr>
<td>reartiresize</td>
<td>string</td>
<td>后轮胎尺寸</td>
</tr>
<tr>
<td>vin</td>
<td>string</td>
<td>车架号</td>
</tr>
<tr>
<td>fueltype</td>
<td>string</td>
<td>燃油类型</td>
</tr>
<tr>
<td>displacement</td>
<td>string</td>
<td>排量 L</td>
</tr>
<tr>
<td>fuelgrade</td>
<td>string</td>
<td>燃油标号</td>
</tr>
<tr>
<td>price</td>
<td>string</td>
<td>厂商指导价</td>
</tr>
<tr>
<td>frontbraketype</td>
<td>string</td>
<td>前制动类型</td>
</tr>
<tr>
<td>rearbraketype</td>
<td>string</td>
<td>后制动类型</td>
</tr>
<tr>
<td>parkingbraketype</td>
<td>string</td>
<td>驻车制动类型</td>
</tr>
<tr>
<td>maxpower</td>
<td>string</td>
<td>最大功率 KW</td>
</tr>
<tr>
<td>sizetype</td>
<td>string</td>
<td>尺寸类型</td>
</tr>
<tr>
<td>gearnum</td>
<td>string</td>
<td>档位数</td>
</tr>
<tr>
<td>geartype</td>
<td>string</td>
<td>变速箱类型</td>
</tr>
<tr>
<td>seatnum</td>
<td>string</td>
<td>座位数</td>
</tr>
<tr>
<td>bodystructure</td>
<td>string</td>
<td>车体结构</td>
</tr>
<tr>
<td>maxhorsepower</td>
<td>string</td>
<td>最大马力(Ps)</td>
</tr>
<tr>
<td>carlist</td>
<td>string</td>
<td>车型列表 可能的车型</td>
</tr>
<tr>
<td>carid</td>
<td>string</td>
<td>车ID 对应车型API中的ID</td>
</tr>
<tr>
<td>logo</td>
<td>string</td>
<td>LOGO</td>
</tr>
<tr>
<td>typeid</td>
<td>int</td>
<td>车型ID 对应车型大全里的根据车型获取车的parentid</td>
</tr>
<tr>
<td>listdate</td>
<td>string</td>
<td>上市日期</td>
</tr>
<tr>
<td>len</td>
<td>string</td>
<td>长 mm</td>
</tr>
<tr>
<td>width</td>
<td>string</td>
<td>宽</td>
</tr>
<tr>
<td>height</td>
<td>string</td>
<td>高</td>
</tr>
<tr>
<td>wheelbase</td>
<td>string</td>
<td>轴距</td>
</tr>
<tr>
<td>weight</td>
<td>string</td>
<td>整备质量 kg</td>
</tr>
<tr>
<td>bodytype</td>
<td>string</td>
<td>车身型式</td>
</tr>
<tr>
<td>typename</td>
<td>string</td>
<td>车型名称 对应typeid</td>
</tr>
<tr>
<td>iscorrect</td>
<td>int</td>
<td>1 VIN符合规则 2 VIN不符合规则</td>
</tr>
<tr>
<td>displacementml</td>
<td>string</td>
<td>排量(mL)</td>
</tr>
<tr>
<td>caridexternal</td>
<td>string</td>
<td>外部ID</td>
</tr>
<tr>
<td>machineoil</td>
<td>string</td>
<td>机油信息</td>
</tr>
<tr>
<td>volume</td>
<td>string</td>
<td>参考用量</td>
</tr>
<tr>
<td>viscosity</td>
<td>string</td>
<td>粘稠度</td>
</tr>
<tr>
<td>grade</td>
<td>string</td>
<td>机油分类</td>
</tr>
<tr>
<td>level</td>
<td>string</td>
<td>质量等级</td>
</tr>
<tr>
<td>gearboxinfo</td>
<td>string</td>
<td>变速箱信息</td>
</tr>
<tr>
<td>gearboxbrand</td>
<td>string</td>
<td>变速箱品牌</td>
</tr>
<tr>
<td>gearboxmodel</td>
<td>string</td>
<td>变速箱型号</td>
</tr>
<tr>
<td>joint</td>
<td>string</td>
<td>接口型号</td>
</tr>
<tr>
<td>gravityoil</td>
<td>string</td>
<td>重力加油量</td>
</tr>
<tr>
<td>mechanicaloil</td>
<td>string</td>
<td>机械加油量</td>
</tr>
<tr>
<td>jointpiclist</td>
<td>string</td>
<td>接口图片列表</td>
</tr>
<tr>
<td>positionpiclist</td>
<td>string</td>
<td>位置图片列表</td>
</tr>
<tr>
<td>checkfillpiclist</td>
<td>string</td>
<td>量油/加注/放油口图片列表</td>
</tr>
<tr>
<td>ratedloadweight</td>
<td>string</td>
<td>额定载质量</td>
</tr>
<tr>
<td>marketprice</td>
<td>string</td>
<td>市场价</td>
</tr>
<tr>
<td>version</td>
<td>string</td>
<td>版本</td>
</tr>
<tr>
<td>isimport</td>
<td>string</td>
<td>是否是进口 0国产 1进口</td>
</tr>
<tr>
<td>groupid</td>
<td>string</td>
<td>车型组ID</td>
</tr>
<tr>
<td>groupname</td>
<td>string</td>
<td>车型组名称</td>
</tr>
<tr>
<td>model</td>
<td>string</td>
<td>工信部型号</td>
</tr>
<tr>
<td>doornum</td>
<td>string</td>
<td>车门数</td>
</tr>
<tr>
<td>fuelmethod</td>
<td>string</td>
<td>供油方式</td>
</tr>
<tr>
<td>cylindernum</td>
<td>string</td>
<td>气缸数(个)</td>
</tr>
<tr>
<td>enginemodel</td>
<td>string</td>
<td>发动机型号（参考）</td>
</tr>
<tr>
<td>chassis</td>
<td>string</td>
<td>冗余字段，null，可忽略</td>
</tr>
</tbody>
</table>
<h4>code返回码说明</h4>
<table>
<thead>
<tr>
<th>code</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>200</td>
<td>成功（计费）</td>
</tr>
<tr>
<td>400</td>
<td>参数错误</td>
</tr>
<tr>
<td>404</td>
<td>接口地址不正确</td>
</tr>
<tr>
<td>500</td>
<td>系统维护，请稍候再试</td>
</tr>
<tr>
<td>501</td>
<td>数据源维护，请稍候再试</td>
</tr>
<tr>
<td>601</td>
<td>接口未开通</td>
</tr>
<tr>
<td>602</td>
<td>账号停用</td>
</tr>
<tr>
<td>603</td>
<td>余额不足请充值</td>
</tr>
<tr>
<td>604</td>
<td>接口停用</td>
</tr>
<tr>
<td>606</td>
<td>调用超限，请稍候再试</td>
</tr>
<tr>
<td>607</td>
<td>ip不在白名单</td>
</tr>
<tr>
<td>609</td>
<td>请求过于频繁，请稍候再试</td>
</tr>
<tr>
<td>610</td>
<td>请求超时</td>
</tr>
<tr>
<td>701</td>
<td>无记录</td>
</tr>
<tr>
<td>999</td>
<td>其他，以实际返回为准</td>
</tr>
</tbody>
</table>