身份证识别

功能描述

支持中国大陆居民二代身份证正反面所有字段的识别，包括姓名、性别、民族、出生日期、住址、公民身份证号、签发机关、有效期限；具备身份证照片、人像照片的裁剪功能和翻拍、PS、复印件告警功能，以及边框和框内遮挡告警、临时身份证告警和身份证有效期不合法告警等扩展功能。

说明：

• 当前身份证识别的图片限制为：要求图片经 Base64 编码后不超过7M，分辨率建议500 × 800以上，支持 PNG、JPG、JPEG、BMP 格式。建议卡片部分占据图片2/3以上。
• 身份证识别为付费服务，计费详情请参见 内容识别费用。
• 该功能目前仅提供 API 使用方式。

请求

上传时处理

身份证图片上传时识别的请求包与 COS 简单上传文件接口一致，只需增加相关处理参数，即可在图片上传时返回识别结果，并可将原图存入到 COS。

PUT /<ObjectKey>?ci-process=IDCardOCR&CardSide=<CardSide>&Config=<Config> HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: <GMT Date>
Authorization: <Auth String>

说明：

Authorization: Auth String （详情请参见 请求签名 文档）。

云上数据处理

云上数据处理请求能够对已存储在 COS 的身份证图片进行相应处理操作，返回识别结果。

GET /<ObjectKey>?ci-process=IDCardOCR&CardSide=<CardSide>&Config=<Config> HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: <GMT Date>
Authorization: <Auth String>

说明：

Authorization: Auth String （详情请参见 请求签名 文档）。

请求参数

请求头

此接口仅使用公共请求头部，详情请参见 公共请求头部 文档。

请求体

该请求无请求体。

响应

响应头

此接口仅返回公共响应头部，详情请参见 公共响应头部 文档。

响应体

该响应体返回为 application/xml 数据，包含完整节点数据的内容展示如下：

<Response>
  <IdInfo>
    身份证识别信息
  </IdInfo>
  <AdvancedInfo>
    身份证识别信息
  </AdvancedInfo>
</Response>

具体的数据内容如下：

Response 的内容：

IdInfo身份证识别信息中包含如下内容：

AdvancedInfo扩展信息信息中包含如下内容：

实际案例

请求

GET /test.jpg?ci-process=IDCardOCR&CardSide=FRONT&Config={"CropIdCard"：true, "CropIdCard"：true} HTTP/1.1
Authorization: q-sign-algorithm=sha1&q-ak=AKIDZfbOAo7cllgPvF9cXFrJD0a1ICvR****&q-sign-time=1497530202;1497610202&q-key-time=1497530202;1497610202&q-header-list=&q-url-param-list=&q-signature=28e9a4986df11bed0255e97ff90500557e0e****
Host: examplebucket-1250000000.cos.ap-beijing.myqcloud.com

响应

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 414641
Date: Thu, 15 Jun 2017 12:37:29 GMT
Server: tencent-image
x-ci-request-id: NTk0MjdmODlfMjQ4OGY3XzYzYzhf****

<Response>
  <IdInfo>
     <Name>李明</Name>
     <Sex>男</Sex>
     <Nation>汉</Nation>
     <Birth>1987/1/1</Birth>
     <Address>北京市石景山区高新技术园腾讯大楼</Address>
     <IdNum>440524198701010014</IdNum>
  </IdInfo>
  <AdvancedInfo>
     <IdCard>裁剪后身份证照片的 Base64 编码</IdCard>
     <Portrait>身份证头像照片的 Base64 编码</Portrait>
  </AdvancedInfo>
</Response>

错误码

以下仅列出了接口业务逻辑相关的错误码，其他错误信息请参见 错误码 文档。