传入照片格式要求
当您在进行人脸比对的时候,请传入满足以下所有条件的两张近期人脸照片。
照片清晰、曝光正常,人脸完整无遮挡、表情自然,脸部无过黑、过亮、光晕等情况,角度无太大偏差。
分辨率不超过1920*1080(高*宽),至少640*480,推荐短边缩放到720像素,压缩率大于0.9。照片高大于宽,如果传入的照片宽大于高,可能会影响检测效果。
照片大小:小于1 MB。
支持传入90、180和270旋转角度的照片,多人脸的情况下会选取最大人脸。
示例如下:
发起认证请求
接口名:CompareFaceVerify。
服务地址:cloudauth.aliyuncs.com(IPv4)或cloudauth-dualstack.aliyuncs.com(IPv6)
请求方法:POST和GET。
传输协议:HTTPS。
接口说明:通过服务端接入实现实人认证的接口。
请求参数
名称 | 类型 | 是否必选 | 描述 | 示例值 |
SceneId | Long | 是 | 认证场景ID。该ID在控制台创建认证场景后自动生成。关于如何创建认证场景,请参见添加认证场景。 | 1000000006 |
OuterOrderNo | String | 是 | 客户服务端自定义的业务唯一标识,用于后续定位排查问题使用。值最长为32位长度的字母数字组合,请确保唯一。 | e0c34a77f5ac40a5aa5e6ed20c353888 |
ProductCode | String | 是 | 固定值:PV_FC。 | PV_FC |
SourceFaceContrastPicture | String | 是 金融级人脸对比方案提供四种传入人脸照片的方式,请您选择其中一种。
| 照片Base64编码。 | /9j/4AAQSkZJRgABAQAASxxxxxxx |
SourceFaceContrastPictureUrl | String | 传入公网可访问的照片URL,用于与传入的底库照片做对比。 | https://cn-shanghai-aliyun-cloudauth-xxxxxx.oss-cn-shanghai.aliyuncs.com/verify/xxxxx/xxxxx.jpeg | |
SourceCertifyId | String | 如果您之前已经通过实人认证,可使用实人认证唯一标识CertifyId,认证时的照片作为人脸比对照片。 | 0bfa7c493f850e5178b9f8613634c9xx | |
SourceOssBucketName | String | 已授权OSS空间的Bucket名。 | cn-shanghai-aliyun-cloudauth-xxxxx | |
SourceOssObjectName | String | 已授权OSS空间的文件名。 | verify/xxxxx/xxxxxx.jpeg | |
TargetFaceContrastPicture | String | 是 金融级人脸对比方案提供四种传入人脸照片的方式,请您选择其中一种。
| 底库照片Base64编码。 | /9j/4AAQSkZJRgABAQAASxxxxxxx |
TargetFaceContrastPictureUrl | String | 传入公网可访问的底库照片URL。 | https://cn-shanghai-aliyun-cloudauth-xxxxxx.oss-cn-shanghai.aliyuncs.com/verify/xxxxx/xxxxx.jpeg | |
TargetCertifyId | String | 如果您之前已通过实人认证,可选择该接口,将实人认证标识CertifyId作为人脸比对照片。 | 0bfa7c493f850e5178b9f8613634c9xx | |
TargetOssBucketName | String | 已授权OSS空间的Bucket名 。 | cn-shanghai-aliyun-cloudauth-xxxxx | |
TargetOssObjectName | String | 已授权OSS空间的文件名。 | verify/xxxxx/xxxxxx.jpeg | |
Crop | String | 否 | 是否允许裁剪人脸图片,默认不允许。
说明 若您请求的图片并非来自标准活体检测SDK采集,建议您允许裁剪人脸图片。 开启该功能后,将会对请求的图片先进行人脸裁剪与矫正,完成后会发起请求服务。 | T |
以Source开头的参数代表您要上传的近期人脸照片参数,以Target开头的参数代表您要上传的底库近期人脸照片参数。传入照片的格式要求请参见传入照片格式要求。
如果您选择OSS方式传入人脸照片,您必须同时传入OssBucketName和OssObjectName字段。
OSS入参格式仅支持开通实人认证时授权的OSS生成的URL、Bucket和文件名 。关于如何查询授权的OSS,请参见授权金融级实人认证访问OSS存储空间。
如果您选择FaceContrastPicture(照片Base64编码)方式传入人脸照片,请注意检查照片大小,不要传入过大的照片;您可以通过OSS方式上传较大的人脸照片。
返回数据
名称 | 类型 | 描述 | 示例值 |
RequestId | String | 请求ID。 | 130A2C10-B9EE-4D84-88E3-5384FF039795 |
Message | String | 错误信息。 | success |
Code | String | 返回码:200表示成功,其他返回码表示失败。 | 200 |
ResultObject.Passed | String | 认证结果。取值:
| T |
ResultObject.CertifyId | String | 08573be80f944d95ac812e019e3655a8 | 实人认证请求的唯一标识。 |
ResultObject.VerifyScore | Float | 人脸比对分。 | 99.60875 |
返回示例
{
"Code": "200",
"Message": "success",
"RequestId": "23699272-B263-4B6C-BC04-0EBA1AB6F6D5",
"ResultObject": {
"Passed": "T",
"VerifyScore": 99.60875
}
}
返回Code和Message
Code | Message | 描述 |
200 | success | 成功。 |
400 | 参数不能为空 | 参数不能为空。 |
401 | 参数非法 | 非法参数。传入的姓名、身份证号码长度必须符合国家标准且不得包含英文字母等特殊字符。 |
402 | 应用配置不存在 | 应用配置不存在。 |
404 | 认证场景配置不存在 | 认证场景配置不存在,请先在控制台上创建认证场景。 |
410 | 未开通服务 | 未开通OSS产品或未完成OSS读写授权,请登录控制台完成授权。 |
411 | RAM 无权限 | 需要给子账号授予AliyunAntCloudAuthFullAccess的操作权限。 |
412 | 欠费中 | 金融级实人认证或OSS存在欠费,请充值后操作。 |
419 | 传入图片不可用 | 图片无法下载、图片内容为空、图片分辨率不符合要求或提取不到人脸特征,建议更换图片。 |
420 | 数据重复 | 图片传入方式超过2种。 |
421 | 传入图片过大 | 图片超过了1 MB,建议压缩图片或更换图片上传方式。 |
422 | 下载图片超时 | 图片下载超过了3秒,请排查网络后重新操作。 |
423 | 状态错误 | 需确保传入的CertifyId认证状态为T或F,或更换其他方式传入照片。 |
500 | 系统错误 | 系统内部错误,请联系工程师排查。 |