本文介绍身份三要素核验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 |
是 |
姓名:
|
|
|
FaceUrl |
String |
否 说明
FaceUrl和FaceFileObject二选一。 |
人脸照片,地址需为公网可访问的HTTP、HTTPS链接。 |
https://www.aliyun.com/cert.jpeg |
|
FaceFileObject |
InputStream |
人脸照片输入流。 |
具体接入方式,请参见文件上传 Advance 接口配置。 |
|
|
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且正确配置环境变量。

