卡证识别

最近更新时间:2024-04-09 15:54:35

我的收藏

功能描述

本接口支持中国大陆居民二代身份证正面(暂不支持背面)、驾驶证主页(暂不支持副页)所有字段的自动定位,暂不支持文本识别,用于对特定字段的抹除、屏蔽,以及进一步的文本识别。
注意:
本接口属于 GET 请求,为同步请求方式,需携带签名,具体签名设置请参见 请求签名

授权说明

通过子账号使用时,需要授予对应权限,COS权限具体请参见 COS action,CI 权限具体请参见 数据万象 action
下载时处理:授权策略中 action 设置为 cos:GetObjectci:CreateAILicenseRecognitionJob
上传时处理:授权策略中 action 设置为 cos:PutObjectci:CreateAILicenseRecognitionJob
云上数据处理:授权策略中 action 设置为 cos:GetObjectcos:PutObjectci:CreateAILicenseRecognitionJob(注意 GetObject 对应的 resource 为源文件,PutObject 对应的 resource 为转存的文件)。

服务开通

使用该功能需提前开通数据万象,并绑定存储桶。详情请参见 绑定存储桶
使用该功能需提前通过控制台或接口开通 AI 内容识别服务 。详情请参见 开通 AI 内容识别服务

使用限制

使用该接口时,请先确认相关限制条件。详情请参见 使用限制

费用说明

该接口为付费服务,产生的费用将由数据万象收取,详细计费说明可参见 内容识别费用

信息说明

身份证正面:包括姓名、性别、民族、出生日期、住址、公民身份证号。 驾驶证主页:包括证号、姓名、性别、国籍、住址、出生日期、初次领证日期、准驾车型、有效期限、发证单位。

请求

请求示例

原图存储在 COS:
GET /<ObjectKey>?ci-process=AILicenseRec&CardType=IDCard HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: <GMT Date>
Authorization: <Auth String>
原图来自其他链接:
GET /?ci-process=AILicenseRec&CardType=IDCard&detect-url=<detect-url> HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: <GMT Date>
Authorization: <Auth String>
说明:
Authorization: Auth String ,详情请参见 请求签名 文档。

请求参数

参数名称
描述
类型
是否必选
ObjectKey
对象文件名,例如:folder/document.jpg
String
ci-process
数据万象处理能力,卡证识别固定为 AILicenseRec
String
detect-url
您可以通过填写 detect-url 处理任意公网可访问的图片链接。不填写 detect-url 时,后台会默认处理 ObjectKey ,填写了 detect-url 时,后台会处理 detect-url 链接,无需再填写 ObjectKey。
detect-url 示例:http://www.example.com/abc.jpg ,需要进行 UrlEncode,处理后为http%25253A%25252F%25252Fwww.example.com%25252Fabc.jpg
String
CardType
卡证识别类型,默认为 DriverLicense。有效值为:
IDCard:表示身份证。
DriverLicense:表示驾驶证。
String

请求头

公共头部

该请求操作的实现使用公共请求头,了解公共请求头详情请参阅 公共请求头部 文档。

非公共头部

该请求操作无特殊的请求头部信息。

请求体

该请求无请求体。

响应

响应头

公共响应头

该响应包含公共响应头,了解公共响应头详情请参阅 公共响应头部 文档。

特有响应头

该响应无特殊的响应头。

响应体

该响应体返回为 application/xml 数据,包含完整节点数据的内容展示如下:
<Response>
<Status>1</Status>
<IdInfo>
<Name>姓名</Name>
<DetectedText>xxx</DetectedText>
<Score>99</Score>
<Location>
<Point>553,439</Point>
<Point>553,576</Point>
<Point>989,576</Point>
<Point>989,439</Point>
</Location>
</IdInfo>
<IdInfo>
<Name>性别</Name>
<DetectedText></DetectedText>
<Score>98</Score>
<Location>
<Point>541,597</Point>
<Point>541,723</Point>
<Point>798,723</Point>
<Point>798,597</Point>
</Location>
</IdInfo>
<IdInfo>
<Name>民族</Name>
<DetectedText></DetectedText>
<Score>98</Score>
<Location>
<Point>1032,599</Point>
<Point>1032,725</Point>
<Point>1265,725</Point>
<Point>1265,599</Point>
</Location>
</IdInfo>
<IdInfo>
<Name>出生(日期)</Name>
<DetectedText>1974年12月1日</DetectedText>
<Score>99</Score>
<Location>
<Point>532,748</Point>
<Point>532,906</Point>
<Point>1346,906</Point>
<Point>1346,748</Point>
</Location>
</IdInfo>
<IdInfo>
<Name>住(地)址</Name>
<DetectedText>湖南省xxxxx</DetectedText>
<Score>99</Score>
<Location>
<Point>534,931</Point>
<Point>534,1253</Point>
<Point>1587,1253</Point>
<Point>1587,931</Point>
</Location>
</IdInfo>
<IdInfo>
<Name>公民身份证号(证号)</Name>
<DetectedText>43xxxx</DetectedText>
<Score>99</Score>
<Location>
<Point>842,1372</Point>
<Point>842,1615</Point>
<Point>2284,1615</Point>
<Point>2284,1372</Point>
</Location>
</IdInfo>
</Response>
具体的数据内容如下:
节点名称(关键字)
父节点
描述
类型
Response
保存结果的容器
Container
Response 的内容:
节点名称(关键字)
父节点
描述
类型
Status
Response
卡证识别结果,1:识别到结果 0:未识别到结果

IdInfo
Response
卡证识别信息。
String
IdInfo节点的内容:
节点名称(关键字)
父节点
描述
类型
Name
IdInfo
字段的名称
String
Score
IdInfo
字段的置信度,取值范围为[0-100],值越高概率越大
Integer
Location
IdInfo
驾驶证中识别到字段的坐标
Container
Location 节点的内容:
节点名称(关键字)
父节点
描述
类型
Point
Location
驾驶证信息 坐标点(X 坐标,Y 坐标)
String

错误码

常见的错误信息请参阅 错误码 文档。

实际案例

使用模板 ID。

请求

GET /<ObjectKey>?CardType=IDCard&ci-process=AILicenseRec HTTP/1.1
Authorization:q-sign-algorithm=sha1&q-ak=AKIDZfbOAo7cllgPvF9cXFrJD0**********&q-sign-time=1497530202;1497610202&q-key-time=1497530202;1497610202&q-header-list=&q-url-param-list=&q-signature=28e9a4986df11bed0255e97ff90500557e0ea057
Host:bucket-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-ci
x-cos-request-id: NTk0MjdmODlfMjQ4OGY3XzYzYzhfMjc=

<Response>
<Status>1</Status>
<IdInfo>
<Name>姓名</Name>
<DetectedText>xxx</DetectedText>
<Score>99</Score>
<Location>
<Point>553,439</Point>
<Point>553,576</Point>
<Point>989,576</Point>
<Point>989,439</Point>
</Location>
</IdInfo>
<IdInfo>
<Name>性别</Name>
<DetectedText></DetectedText>
<Score>98</Score>
<Location>
<Point>541,597</Point>
<Point>541,723</Point>
<Point>798,723</Point>
<Point>798,597</Point>
</Location>
</IdInfo>
<IdInfo>
<Name>民族</Name>
<DetectedText></DetectedText>
<Score>98</Score>
<Location>
<Point>1032,599</Point>
<Point>1032,725</Point>
<Point>1265,725</Point>
<Point>1265,599</Point>
</Location>
</IdInfo>
<IdInfo>
<Name>出生(日期)</Name>
<DetectedText>1974年12月1日</DetectedText>
<Score>99</Score>
<Location>
<Point>532,748</Point>
<Point>532,906</Point>
<Point>1346,906</Point>
<Point>1346,748</Point>
</Location>
</IdInfo>
<IdInfo>
<Name>住(地)址</Name>
<DetectedText>湖南省xxxxx</DetectedText>
<Score>99</Score>
<Location>
<Point>534,931</Point>
<Point>534,1253</Point>
<Point>1587,1253</Point>
<Point>1587,931</Point>
</Location>
</IdInfo>
<IdInfo>
<Name>公民身份证号(证号)</Name>
<DetectedText>43xxxx</DetectedText>
<Score>99</Score>
<Location>
<Point>842,1372</Point>
<Point>842,1615</Point>
<Point>2284,1615</Point>
<Point>2284,1372</Point>
</Location>
</IdInfo>
</Response>