本文介绍身份二要素核验(支持OCR)API接口。传入二代身份证图片(包括:国徽面和人像面),OCR提取姓名和身份证号,通过权威源核验其真实性及一致性。
接口信息
在使用本接口前,请确保已完整阅读接入流程,并开通服务。
-
接口名: Id2MetaVerifyWithOCR
-
接口说明:传入二代身份证图片(包括:国徽面和人像面),OCR提取姓名和身份证号,通过权威源核验其真实性及一致性。
-
QPS限量:API独享QPS限量,详情请参见信息核验接口QPS限量说明。
-
服务地址(调用 API 时的 Endpoint):
地域
IPv4
IPv6
通用
cloudauth.aliyuncs.com
cloudauth-dualstack.aliyuncs.com
北京
cloudauth.cn-beijing.aliyuncs.com
cloudauth-dualstack.cn-beijing.aliyuncs.com
上海
cloudauth.cn-shanghai.aliyuncs.com
cloudauth-dualstack.cn-shanghai.aliyuncs.com
说明服务地址可选择与业务服务器距离相近的 endpoint ,以降低延迟。
也可以构建列表轮询使用,以提高可用性。
出入图片格式要求
-
图片大小:图片大小不超过2 MB。图片过大可能会影响接口响应速度,甚至可能导致读取图片超时失败。
-
图片格式:PNG、JPG、JPEG。
-
图片分辨率:图片长宽需要大于64像素且小于8192像素。
-
图片质量要求:图片模糊、内容遮挡、光线或图片角度异常都可能会对识别结果产生影响;在识别身份证人像面时,需要确保人脸呈现正向。
请求参数
|
名称 |
类型 |
是否必选 |
描述 |
示例值 |
|
CertUrl |
String |
是 重要
CertUrl和CertFileObject二选一。 |
https://www.aliyun.com/cert.jpeg |
身份证人像面图片。 公网可访问的HTTP、HTTPS链接。 |
|
CertFileObject |
InputStream |
无 |
身份证人像面图片输入流。具体接入方式,请参见文件上传 Advance 接口配置。 |
|
|
CertNationalUrl |
String |
否 重要
CertNationalUrl和CertNationalFileObject二选一入参,也可以都不传递。 |
https://www.aliyun.com/cert.jpeg |
身份证国徽面图片地址。国徽面 公网可访问的HTTP、HTTPS链接。 |
|
CertNationalFileObject |
InputStream |
无 |
身份证国徽面图片地址。具体接入方式,请参见文件上传 Advance 接口配置。 |
响应参数
|
名称 |
类型 |
描述 |
示例值 |
|
|
RequestId |
String |
请求ID。 |
130A2C10-B9EE-4D84-88E3-5384FF03**** |
|
|
Message |
String |
接口调用返回信息。 重要
此参数仅表示接口是否异常。 |
success |
|
|
Code |
String |
返回码:200表示成功,其他均为失败。 重要
|
200 |
|
|
ResultObject |
BizCode |
String |
身份核验结果:
|
1 |
|
CardInfo |
String |
|
OCR读取的身份证信息。可在ResultObject.CardInfo字段说明中查看详情。 |
|
ResultObject.CardInfo字段说明
|
名称 |
类型 |
示例值 |
描述 |
|
address |
String |
xx省xx市xx区xx969号 |
身份证上的住址。 |
|
birthDate |
String |
19901xxx |
身份证上的出生日期。 |
|
certName |
String |
张三 |
身份证上的姓名。 |
|
certNo |
String |
1234561990122***** |
身份证号。 |
|
nationality |
String |
汉 |
民族。 |
|
authority |
String |
xxx公安局 |
签发机关。 |
|
startDate |
String |
20201130 |
有效期限开始时间。 |
|
endDate |
String |
20301130 |
有效期限结束时间。 |
SDK调用示例
集成前请确保您已完整阅读接入流程,开通了服务并获取AccessKey且正确配置环境变量。