驾驶证查询（停）
<h3>接口描述</h3>
<ul>
<li>输入姓名、驾驶证号查询驾驶证信息</li>
</ul>
<h3>请求地址</h3>
<p><code>https://api.jumdata.com/vehicle/driver-license</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>varchar</td>
<td>是</td>
<td>服务商分配的唯一标识</td>
</tr>
<tr>
<td>timestamp</td>
<td>number</td>
<td>是</td>
<td>当前时间的毫秒数</td>
</tr>
<tr>
<td>sign</td>
<td>varchar</td>
<td>是</td>
<td>签名，<a href='#sign'>签名算法说明</a></td>
</tr>
<tr>
<td>name</td>
<td>varchar</td>
<td>是</td>
<td>姓名</td>
</tr>
<tr>
<td>licenseno</td>
<td>varchar</td>
<td>是</td>
<td>驾驶证号，同身份证号</td>
</tr>
</tbody>
</table>
<p><a name="sign"></a></p>
<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 = "xyzxy2121zxyz"；
String timestamp = "1555378976238"；
String appSecret = "efcefcef1121cefcefc1212121"；
String str = appId + appSecret + timestamp；
String sign = sha256(str)；</code></pre>
<h3>正确返回</h3>
<pre><code class="language-json">{
"data": {
"file_number": "",
"scoring": "",
"valid_date": "2030-12-30",
"issue_date": "2014-12-30",
"issue_by": "",
"valid_from": "2020-12-30",
"driver_status": "A",
"class": "C1",
"name_verify": "1"
},
"msg": "成功",
"code": 200,
"taskNo": "25715056486342543798"
}</code></pre>
<h3>错误返回</h3>
<pre><code class="language-json">{
"msg": "未查得",
"code": 701,
"taskNo": "43095254608543383435"
}</code></pre>
<h3>返回字段说明</h3>
<table>
<thead>
<tr>
<th>字段名</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>code</td>
<td>成功为200，其它为失败</td>
</tr>
<tr>
<td>msg</td>
<td>code对应的说明描述</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>
</tr>
</thead>
<tbody>
<tr>
<td>file_number</td>
<td>档案编号</td>
</tr>
<tr>
<td>scoring</td>
<td>累计计分</td>
</tr>
<tr>
<td>valid_date</td>
<td>有效期至</td>
</tr>
<tr>
<td>issue_date</td>
<td>初次领证时间</td>
</tr>
<tr>
<td>issue_by</td>
<td>签发机关</td>
</tr>
<tr>
<td>valid_from</td>
<td>有效期始</td>
</tr>
<tr>
<td>driver_status</td>
<td>驾驶证状态，<a href='#driver_status'>状态列表</a></td>
</tr>
<tr>
<td>class</td>
<td>准驾车型</td>
</tr>
<tr>
<td>name_verify</td>
<td>姓名 一致/不一致</td>
</tr>
</tbody>
</table>
<h4>code返回码说明</h4>
<table>
<thead>
<tr>
<th>code</th>
<th>说明</th>
<th>是否计费</th>
</tr>
</thead>
<tbody>
<tr>
<td>200</td>
<td>成功</td>
<td>是</td>
</tr>
<tr>
<td>400</td>
<td>参数错误</td>
<td>否</td>
</tr>
<tr>
<td>404</td>
<td>请求资源不存在</td>
<td>否</td>
</tr>
<tr>
<td>500</td>
<td>系统内部错误，请联系服务商</td>
<td>否</td>
</tr>
<tr>
<td>501</td>
<td>第三方服务异常</td>
<td>否</td>
</tr>
<tr>
<td>601</td>
<td>服务商未开通接口权限</td>
<td>否</td>
</tr>
<tr>
<td>602</td>
<td>账号停用</td>
<td>否</td>
</tr>
<tr>
<td>603</td>
<td>余额不足请充值</td>
<td>否</td>
</tr>
<tr>
<td>604</td>
<td>接口停用</td>
<td>否</td>
</tr>
<tr>
<td>701</td>
<td>未查得</td>
<td>否</td>
</tr>
<tr>
<td>999</td>
<td>其他信息错误</td>
<td>否</td>
</tr>
</tbody>
</table>
<p><a name='driver_status'></a></p>
<h4>驾驶证状态</h4>
<table>
<thead>
<tr>
<th>状态</th>
<th>名称</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>A</td>
<td>正常</td>
<td>正常情况</td>
</tr>
<tr>
<td>B</td>
<td>满分</td>
<td>驾驶人违法记录累计超12分</td>
</tr>
<tr>
<td>C</td>
<td>转出</td>
<td>该驾驶人已从本地辖区转出</td>
</tr>
<tr>
<td>D</td>
<td>暂扣</td>
<td>驾驶证正在扣证期间内</td>
</tr>
<tr>
<td>E</td>
<td>撤销</td>
<td>以欺骗、贿赂等不正当手段取得驾驶许可</td>
</tr>
<tr>
<td>F</td>
<td>吊销</td>
<td></td>
</tr>
<tr>
<td>G</td>
<td>注销</td>
<td>该驾驶证已被注销</td>
</tr>
<tr>
<td>H</td>
<td>违法未处理</td>
<td>该驾驶人处于违法处理期</td>
</tr>
<tr>
<td>I</td>
<td>事故未处理</td>
<td></td>
</tr>
<tr>
<td>J</td>
<td>停止使用</td>
<td>超过12分3个月未处理；机动车驾驶人计分达到12分；拒不参加公安机关交通管理部门通知的学习，也不能接受考试的</td>
</tr>
<tr>
<td>K</td>
<td>协查</td>
<td>指法院等发协查函的</td>
</tr>
<tr>
<td>L</td>
<td>锁定</td>
<td></td>
</tr>
<tr>
<td>Z</td>
<td>其他</td>
<td></td>
</tr>
</tbody>
</table>