验真平台API文档


驾驶证OCR(driving_license_ocr)

<p>[TOC]</p> <h5>产品描述</h5> <ul> <li>检测和识别中华人民共和国机动车驾驶证图像为结构化的文字信息,支持驾驶证主页的正面和副业的正面</li> </ul> <h5>接口地址</h5> <ul> <li>请求地址:<code>https://api.caih.com/verify/api/driving_license_ocr</code></li> <li>请求方式:POST</li> <li>接口数据类型:multipart/form-data</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>imageType</td> <td>是</td> <td>string</td> <td>图片类型的枚举值:</br>FILE:图片文件</br>BASE64:图片的base64编码</br>默认值:FILE</td> </tr> <tr> <td>file</td> <td>否</td> <td>file</td> <td>图片的二进制文件,imageType为FILE时为必填</td> </tr> <tr> <td>base64</td> <td>否</td> <td>string</td> <td>图片的base64编码字符串,无图片头,imageType为BASE64时为必填</td> </tr> </tbody> </table> <p>图片格式为 jpg( jpeg), bmp, png(大小写均可),宽和⾼⼩于等于4000px,大小不能超过1MB。</p> <h5>请求示例</h5> <pre><code>appid=607785267fb42ad9b5bb701ada446512&amp; sign=eb514ea44c6586664d04240ea51be20b&amp; userkey=36e2a500839a49653de14fc3d7a24812&amp; timestamp=20190523151159&amp; imageType=BASE64&amp; base64=/9j/4AAQSkZJRgABAQIAdgB2AAD/2wBDAAgGBgcGBQgHB</code></pre> <h5>产品响应参数(data)</h5> <p>验真状态码及描述请查看本页章节 <code>验真状态码及描述</code> 。</p> <table> <thead> <tr> <th>参数名</th> <th>是否必填</th> <th>类型</th> <th>父元素</th> <th><div style="width: 300px"/>说明</th> </tr> </thead> <tbody> <tr> <td>state</td> <td>是</td> <td>string</td> <td>data</td> <td>验真状态码</td> </tr> <tr> <td>desc</td> <td>是</td> <td>string</td> <td>data</td> <td>验真状态码描述</td> </tr> <tr> <td>pageB</td> <td>否</td> <td>json</td> <td>data</td> <td>副页</td> </tr> <tr> <td>id</td> <td>否</td> <td>string</td> <td>pageB</td> <td>证号</td> </tr> <tr> <td>name</td> <td>否</td> <td>string</td> <td>pageB</td> <td>姓名</td> </tr> <tr> <td>fileNumber</td> <td>否</td> <td>string</td> <td>pageB</td> <td>档案编号</td> </tr> <tr> <td>pageA</td> <td>否</td> <td>json</td> <td>data</td> <td>正页</td> </tr> <tr> <td>verison</td> <td>否</td> <td>string</td> <td>pageA</td> <td>驾驶证版本枚举值:</br>1:2008或更早版本驾驶证</br>2:2013版本驾驶证</td> </tr> <tr> <td>id</td> <td>否</td> <td>string</td> <td>pageA</td> <td>证号</td> </tr> <tr> <td>name</td> <td>否</td> <td>string</td> <td>pageA</td> <td>姓名</td> </tr> <tr> <td>sex</td> <td>否</td> <td>string</td> <td>pageA</td> <td>性别</td> </tr> <tr> <td>nationality</td> <td>否</td> <td>string</td> <td>pageA</td> <td>国籍</td> </tr> <tr> <td>address</td> <td>否</td> <td>string</td> <td>pageA</td> <td>住址</td> </tr> <tr> <td>dateOfBirth</td> <td>否</td> <td>string</td> <td>pageA</td> <td>出生日期</td> </tr> <tr> <td>dateOfFirstIssue</td> <td>否</td> <td>string</td> <td>pageA</td> <td>初次领证日期</td> </tr> <tr> <td>drivingType</td> <td>否</td> <td>string</td> <td>pageA</td> <td>准驾车型</td> </tr> <tr> <td>beginDate</td> <td>否</td> <td>string</td> <td>pageA</td> <td>有效期限,格式为:YYYY-MM-DD</td> </tr> <tr> <td>endDate</td> <td>否</td> <td>string</td> <td>pageA</td> <td>有效期截止日:</br>version为1:格式为*年,例如:10年</br>version为2:格式为YYYY-MM-DD</td> </tr> </tbody> </table> <h5>返回示例</h5> <h6>查询成功</h6> <p>2013版本驾驶证:</p> <pre><code>{ (统一响应参数) "data": { "state": "1", "desc": "成功", "pageB": { "fileNumber": "1100***", "name": "王**", "id": "340104***" }, "pageA": { "beginDate": "2018-04-18", "endDate": "2028-04-18", "address": "北京市海淀区中关村***", "sex": "女", "dateOfFirstIssue": "2012-04-18", "dateOfBirth": "1976-12-19", "nationality": "中国", "name": "王**", "id": "340104***", "drivingType": "C1", "version": "2" } } }</code></pre> <p>2008或更早版本驾驶证:</p> <pre><code>{ (统一响应参数) "data": { "state": "1", "desc": "成功", "pageB": { "fileNumber": "1100***", "name": "王**", "id": "340104***" }, "pageA": { "beginDate": "2018-04-18", "endDate": "10年", "address": "北京市海淀区中关村***", "sex": "女", "dateOfFirstIssue": "2012-04-18", "dateOfBirth": "1976-12-19", "nationality": "中国", "name": "王**", "id": "340104***", "drivingType": "C1", "version": "1" } } }</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> </tbody> </table>

页面列表

ITEM_HTML