利用OCR技术识别并返回身份证正反面相关文本信息

DEMO体验

接口说明

该接口目前可返回如下两种识别结果：

• 检测成功：OCR成功识别证件信息，并返回OCR识别信息字段，识别准确率99%

• 非身份证照片或检测不出身份证信息：上传的照片为非身份证照片，或因像素或拍摄角度等原因造成OCR无法识别出证件信息，建议提示用户横放拍摄，并确保画面80%身份证主体部分重新上传重试。

您可以选择直接使用本API接口，也可以搭配身份证OCR SDK进行使用

鉴权说明

易盾信息认证服务使用签名方法对接口进行鉴权，所有接口每一次请求都需要包含签名信息（signature参数），以验证用户身份，防止信息被恶意篡改。目前支持MD5，SHA1，SHA256，SM3几种加密算法，详细信息，请参见接口鉴权

请求

请求地址

名称	值
HTTP URL	https://verify.dun.163.com/v1/ocr/check
HTTP Method	POST

请求头

名称	类型	必填	描述
Content-Type	String	是	固定值："application/x-www-form-urlencoded"

请求参数

请求参数由请求公共参数和请求业务参数两部分组成，通用参数见请求通用字段

名称	类 型	必填	最大长度	描述
picType	Number	是	4	图片类型：1-URL,2-BASE64 ，编码后的base64大小限制为大小3M
frontPicture	String	否	1M	身份证正面照（人像面）,可支持PNG、JPG、BMP图片文件，不支持GIF图片 为保证正常识别效果，请横放拍摄，并确保画面80%身份证主体部分。 网络带宽请根据自身业务QPS准备，建议准备320Mbps，即可应对绝大部分场景
backPicture	String	否	1M	身份证背面照（国徽面）
dataId	String	否	64	数据标识，可传入用户标识等数据，便于数据查询

身份证正反面照片任传其一和都传均可，但两者不可同时不传。
强烈建议开发者要求自己的用户实时拍摄身份证上传，禁用相册选择功能
若为境外服务器，请告知客服域名为您进行代理配置

请求体示例

picType=2&frontPicture=xxx&backPicture=xxx&version=v1&businessId=xxx&timestamp=1638180222235&nonce=xxx&secretId=xxx&signature=xxx

响应

响应结果

响应字段如下，响应通用字段已省略，详细见响应公共字段

参数名称	类型	必须返回	描述
status	Number	是	1-识别成功，信息无误 2-非身份证照片或检测不出身份证信息 3-识别成功，但身份证号校验不通过，请复查用户证件是否作弊 4-识别成功，但姓名不合规范，请复查用户证件是否作弊 5-识别成功，但身份证有效期出现错误，请复查用户证件是否作弊 6-图片下载失败，请重试 7-检测异常
taskId	String	是	本次请求数据标识，可以根据该标识查询数据最新结果
isPayed	Number	是	本次请求是否收费标识，1代表收费，0代表不收费
ocrResponseDetail	Object	否	解析的图片数据
∟ ocrName	String	否	姓名
∟ ocrCardNo	String	否	身份证号码
∟ expireDate	String	否	身份证开始时间与有效期截止时间
∟ gender	String	否	性别
∟ nation	Integer	否	民族
∟ birthday	String	否	出生日期
∟ address	String	否	地址
∟ authority	String	否	发证机关

响应体示例

{
    "code": 200,
    "msg": "ok",
    "result": {
        "status": 1,
        "taskId": "xxxxxxxxxxxxxx",
        "isPayed": 1,
        "ocrResponseDetail": {
            "ocrName": "张三",
            "ocrCardNo": "360xxxxxxxxxx",
            "expireDate": "2013020520230205",
            "gender": "男",
            "nation":"汉族",
            "birthday":"xxxx-xx-xx",
            "address":"xxx",
            "authority":"xxx",
        }
    }
}

响应返回码

响应返回码见：响应返回码