驾驶证信息查验（driving_license_query）
<p>[TOC]</p>
<h5>产品描述</h5>
<ul>
<li>通过姓名、驾驶证号（身份证号）返回驾驶证的准驾车型、驾驶证状态等信息。</li>
</ul>
<h5>接口地址</h5>
<ul>
<li>请求地址：<code>https://api.caih.com/verify/api/driving_license_query</code></li>
<li>请求方式：POST</li>
<li>接口数据类型：JSON</li>
<li>编码方式：UTF-8</li>
<li>接口参数传递位置：请求体body</li>
<li>接口参数传递内容：认证信息参数（authinfo）和校验请求参数（param）</li>
</ul>
<h5>接口须知</h5>
<ul>
<li><strong>认证信息参数</strong> 和 <strong>统一响应参数</strong>请查看页面 <a href="https://www.showdoc.cc/p/52021eddfd9994a7b84d891a16e27f66" title="认证信息参数和统一响应参数">认证信息参数和统一响应参数</a></li>
<li>如需加密对接请查看页面 <a href="https://www.showdoc.cc/p/dfff667dec3c68748dddde67674eb993" title="加密对接说明">加密对接说明</a>，并联系运营人员进行配置</li>
</ul>
<h5>校验请求参数（param）</h5>
<table>
<thead>
<tr>
<th>参数名</th>
<th>是否必填</th>
<th>类型</th>
<th><div style="width: 400px"/>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>name</td>
<td>是</td>
<td>string</td>
<td>姓名</td>
</tr>
<tr>
<td>driveLicenseCode</td>
<td>是</td>
<td>string</td>
<td>驾驶证号，即身份证号</td>
</tr>
</tbody>
</table>
<h5>请求示例</h5>
<pre><code>{
(认证信息参数)
"param": {
"name": "王小二",
"driveLicenseCode": "412825199401011234"
}
}</code></pre>
<h5>产品响应参数（data）</h5>
<p>验真状态码及描述请查看本页章节 <code>验真状态码及描述</code> 。
驾驶证状态码及描述请查看本页章节 <code>驾驶证状态码及描述</code> 。</p>
<table>
<thead>
<tr>
<th>参数名</th>
<th>是否必填</th>
<th>类型</th>
<th><div style="width: 400px"/>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>state</td>
<td>是</td>
<td>string</td>
<td>验真状态码</td>
</tr>
<tr>
<td>desc</td>
<td>是</td>
<td>string</td>
<td>验真状态码描述</td>
</tr>
<tr>
<td>drivingClass</td>
<td>否</td>
<td>string</td>
<td>准驾车型，如：C1</td>
</tr>
<tr>
<td>drivingLicenseState</td>
<td>否</td>
<td>string</td>
<td>驾驶证状态码</td>
</tr>
<tr>
<td>drivingLicenseStateDesc</td>
<td>否</td>
<td>string</td>
<td>驾驶证状态码描述</td>
</tr>
<tr>
<td>issueDate</td>
<td>否</td>
<td>string</td>
<td>初次领证时间，格式：yyyy-MM-dd</td>
</tr>
<tr>
<td>validFrom</td>
<td>否</td>
<td>string</td>
<td>有效起始日期，格式：yyyy-MM-dd</td>
</tr>
<tr>
<td>validTo</td>
<td>否</td>
<td>string</td>
<td>有效截止日期，格式：yyyy-MM-dd</td>
</tr>
<tr>
<td>name</td>
<td>否</td>
<td>string</td>
<td>姓名，客户请求参数返回</td>
</tr>
<tr>
<td>driveLicenseCode</td>
<td>否</td>
<td>string</td>
<td>驾驶证号，即身份证号，客户请求参数返回</td>
</tr>
</tbody>
</table>
<h5>返回示例</h5>
<h6>查询成功</h6>
<pre><code>{
(统一响应参数)
"data": {
"state": "1",
"desc": "查询成功有数据",
"drivingClass": "C1",
"drivingLicenseState": "A",
"drivingLicenseStateDesc": "正常",
"issueDate": "2020-01-01",
"validFrom": "2020-02-02",
"validTo": "2028-02-02",
"name": "王小二",
"driveLicenseCode": "412825199401011234",
}
}</code></pre>
<h6>查询失败</h6>
<pre><code>{
(统一响应参数)
"data": {
"state": "0",
"desc": "失败"
}
}</code></pre>
<h5>验真状态码及描述</h5>
<table>
<thead>
<tr>
<th>验真状态码（state）</th>
<th>验真状态码描述（desc）</th>
<th>是否收费</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>0</td>
<td>失败</td>
<td>否</td>
</tr>
<tr>
<td>1</td>
<td>查询成功有数据</td>
<td>是</td>
<td>该情况有其他响应参数</td>
</tr>
<tr>
<td>2</td>
<td>查询成功无数据</td>
<td>是</td>
<td>库无、限制查询的驾驶证，会返回该状态码</td>
</tr>
<tr>
<td>3</td>
<td>姓名和驾驶证号不一致</td>
<td>是</td>
</tr>
</tbody>
</table>
<p>限制查询的驾驶证：白名单、调查人员、经济问题、儿童证件号、事故未处理问题等等。白名单里面又包含：政府机要职能部门如公安、国安等，以及重要科研人员等</p>
<h5>驾驶证状态码及描述</h5>
<p>若驾驶证状态码为叠加状态，如：违法未处理和扣留同时存在，则驾驶证状态码为：HU，驾驶证状态码描述为：违法未处理、扣留，中间用中文的顿号（、）相连</p>
<table>
<thead>
<tr>
<th>驾驶证状态码（drivingLicenseState）</th>
<th>驾驶证状态码描述（drivingLicenseDesc）</th>
</tr>
</thead>
<tbody>
<tr>
<td>A</td>
<td>正常</td>
</tr>
<tr>
<td>B</td>
<td>超分</td>
</tr>
<tr>
<td>C</td>
<td>转出</td>
</tr>
<tr>
<td>D</td>
<td>暂扣</td>
</tr>
<tr>
<td>E</td>
<td>撤销</td>
</tr>
<tr>
<td>F</td>
<td>吊销</td>
</tr>
<tr>
<td>G</td>
<td>注销</td>
</tr>
<tr>
<td>H</td>
<td>违法未处理</td>
</tr>
<tr>
<td>I</td>
<td>事故未处理</td>
</tr>
<tr>
<td>J</td>
<td>停止使用</td>
</tr>
<tr>
<td>K</td>
<td>协查</td>
</tr>
<tr>
<td>L</td>
<td>锁定</td>
</tr>
<tr>
<td>M</td>
<td>逾期未换证</td>
</tr>
<tr>
<td>N</td>
<td>延期换证</td>
</tr>
<tr>
<td>P</td>
<td>延期体检</td>
</tr>
<tr>
<td>R</td>
<td>逾期未体检</td>
</tr>
<tr>
<td>Z</td>
<td>其他</td>
</tr>
<tr>
<td>S</td>
<td>逾期未审验</td>
</tr>
<tr>
<td>T</td>
<td>延期审验</td>
</tr>
<tr>
<td>U</td>
<td>扣留</td>
</tr>
<tr>
<td>V</td>
<td>注销可恢复</td>
</tr>
</tbody>
</table>