本文介绍身份三要素核验API接口。身份三要素指姓名、身份证号和人脸照片。接口会对比三者的真实性和一致性。
接口信息
在使用本接口前,请确保已完整阅读接入流程,并开通服务。
接口名: Id3MetaVerify
接口说明:传入姓名、身份证号和人脸照片,通过权威源核验其真实性和一致性。
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 ,以降低延迟。
也可以构建列表轮询使用,以提高可用性。
请求参数
入参图片格式要求:
图片格式:PNG、JPG、JPEG。
认证主体的近期照片,人脸需要完整清晰无遮挡、表情自然且正对摄像头。
照片清晰、曝光正常,脸部无过黑、过亮、光晕等情况、角度无太大偏差。
分辨率不超过1920*1080(高*宽),至少为640*480,推荐短边缩放到720像素,压缩率大于0.9。照片高大于宽,如果传入的照片宽大于高,可能会影响检测效果。
照片大小需要小于1 MB。
名称 | 类型 | 是否必选 | 描述 | 示例值 |
ParamType | String | 是 | 加密方式:
重要
| normal |
IdentifyNum | String | 是 | 身份证号: 说明 仅支持二代居民身份证和港澳台居住证的证件号码。
|
|
UserName | String | 是 | 姓名:
|
|
FacetUrl | String | 否 说明 FacetUrl和FaceFileObject二选一。 | 人像面图片,地址需为公网可访问的HTTP、HTTPS链接。 | https://www.aliyun.com/cert.jpeg |
FaceFileObject | InputStream | 人像面图片输入流。 | - | |
Crop | String | 否 | 允许裁剪人脸图片:
说明 若您请求的图片并非来自标准活体检测SDK采集,建议您允许裁剪人脸图片。 开启该功能后,将会对请求的图片先进行人脸裁剪与矫正,完成后会发起请求服务。 | T |
响应参数
名称 | 类型 | 描述 | 示例值 | |
RequestId | String | 请求ID。 | 130A2C10-B9EE-4D84-88E3-5384FF039795 | |
Message | String | 接口调用返回信息。 重要 此参数仅表示接口是否异常。 | success | |
Code | String | 返回码:200表示成功,其他均为失败。 重要
| 200 | |
ResultObject | BizCode | String | 身份核验结果:
| 1 |
FaceDetail | String | 人像比对分值,取值范围:0~100,分值越大,相同人脸概率越高,默认阈值是90(即大于等于90,系统判定为相同人脸)。 |
|
SDK调用示例
集成前请确保您已完整阅读接入流程,开通了服务并获取AccessKey且正确配置环境变量。