道路运输从业人员资格证核验（transport_practitioner_cert）
<p>[TOC]</p>
<h5>产品描述</h5>
<ul>
<li>通过身份证号，省行政区划分代码，证件有效期返回运输许可证相关信息，证照状态，运营状态，经营范围等，并根据输入的证件有效期验证证件是否过期。</li>
</ul>
<h5>接口地址</h5>
<ul>
<li>请求地址：<code>https://api.caih.com/verify/api/transport_practitioner_cert</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>idcode</td>
<td>是</td>
<td>string</td>
<td>身份证号</td>
</tr>
<tr>
<td>provinceCode</td>
<td>是</td>
<td>string</td>
<td>发证机关的省行政区规划码，两位数字，具体见本页章节 <code>省行政区规划码</code></td>
</tr>
<tr>
<td>certValidityDate</td>
<td>否</td>
<td>string</td>
<td>证件有效期，格式：yyyyMMdd，不传则无响应参数中的verifiedValidityDate</td>
</tr>
</tbody>
</table>
<h5>请求示例</h5>
<pre><code>{
(认证信息参数)
"param": {
"name": "王小二",
"idcode": "412825199401011234",
"provinceCode": "11"
}
}</code></pre>
<h5>产品响应参数（data）</h5>
<p>验真状态码及描述请查看本页章节 <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>certificateState</td>
<td>否</td>
<td>string</td>
<td>证照状态</td>
</tr>
<tr>
<td>licenseIssueOrganCode</td>
<td>否</td>
<td>string</td>
<td>发证机关</td>
</tr>
<tr>
<td>maturityWarning</td>
<td>否</td>
<td>string</td>
<td>到期预警，有效期不足半月预警提示，<br/>0：有效期超过半月；1：有效期不足半月</td>
</tr>
<tr>
<td>verifiedValidityDate</td>
<td>否</td>
<td>string</td>
<td>有效期核验，若输入参数有certValidityDate且格式正确则该字段有内容，<br/>输入的日期在证件发证日期~有效期至内即为一致，<br/>0：不一致；1：一致</td>
</tr>
<tr>
<td>quasiDriveType</td>
<td>否</td>
<td>string</td>
<td>准驾车型</td>
</tr>
<tr>
<td>certificateCode</td>
<td>否</td>
<td>string</td>
<td>从业资格证号，脱敏数据</td>
</tr>
<tr>
<td>certificateIssueDate</td>
<td>否</td>
<td>string</td>
<td>证件发证日期，格式：yyyy-MM-dd</td>
</tr>
<tr>
<td>certificateExpireDate</td>
<td>否</td>
<td>string</td>
<td>证件有效期至，格式：yyyy-MM-dd</td>
</tr>
<tr>
<td>workType</td>
<td>否</td>
<td>string</td>
<td>经营范围</td>
</tr>
</tbody>
</table>
<h5>返回示例</h5>
<h6>查询成功</h6>
<pre><code>{
(统一响应参数)
"data": {
"state": "1",
"desc": "查询成功有数据",
"certificateState":"有效",
"licenseIssueOrganCode":"北京市交通委员会",
"maturityWarning":"0",
"verifiedValidityDate":"",
"quasiDriveType":"小型汽车",
"certificateCode":"41**************75",
"certificateIssueDate":"2016-07-13",
"certificateExpireDate":"2022-07-12",
"workType":"经营性道路货物运输驾驶员"
}
}</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>
</tr>
</tbody>
</table>
<h5>省行政区规划码</h5>
<table>
<thead>
<tr>
<th>规划码</th>
<th>省份名称</th>
</tr>
</thead>
<tbody>
<tr>
<td>11</td>
<td>北京</td>
</tr>
<tr>
<td>12</td>
<td>天津</td>
</tr>
<tr>
<td>13</td>
<td>河北</td>
</tr>
<tr>
<td>14</td>
<td>山西</td>
</tr>
<tr>
<td>15</td>
<td>内蒙古</td>
</tr>
<tr>
<td>21</td>
<td>辽宁</td>
</tr>
<tr>
<td>22</td>
<td>吉林</td>
</tr>
<tr>
<td>23</td>
<td>黑龙江</td>
</tr>
<tr>
<td>31</td>
<td>上海</td>
</tr>
<tr>
<td>32</td>
<td>江苏</td>
</tr>
<tr>
<td>33</td>
<td>浙江</td>
</tr>
<tr>
<td>34</td>
<td>安徽</td>
</tr>
<tr>
<td>35</td>
<td>福建</td>
</tr>
<tr>
<td>36</td>
<td>江西</td>
</tr>
<tr>
<td>37</td>
<td>山东</td>
</tr>
<tr>
<td>41</td>
<td>河南</td>
</tr>
<tr>
<td>42</td>
<td>湖北</td>
</tr>
<tr>
<td>43</td>
<td>湖南</td>
</tr>
<tr>
<td>44</td>
<td>广东</td>
</tr>
<tr>
<td>45</td>
<td>广西</td>
</tr>
<tr>
<td>46</td>
<td>海南</td>
</tr>
<tr>
<td>50</td>
<td>重庆</td>
</tr>
<tr>
<td>51</td>
<td>四川</td>
</tr>
<tr>
<td>52</td>
<td>贵州</td>
</tr>
<tr>
<td>53</td>
<td>云南</td>
</tr>
<tr>
<td>54</td>
<td>西藏</td>
</tr>
<tr>
<td>61</td>
<td>陕西</td>
</tr>
<tr>
<td>62</td>
<td>甘肃</td>
</tr>
<tr>
<td>63</td>
<td>青海</td>
</tr>
<tr>
<td>64</td>
<td>宁夏</td>
</tr>
<tr>
<td>65</td>
<td>新疆</td>
</tr>
<tr>
<td>71</td>
<td>台湾</td>
</tr>
<tr>
<td>81</td>
<td>香港</td>
</tr>
<tr>
<td>82</td>
<td>澳门</td>
</tr>
</tbody>
</table>