本文介绍了如何通过InitFaceVerify接口进行活体人脸验证。

传入图片格式要求

当您的终端用户在进行实人认证的时候,请传入的图片满足以下所有条件:

  • 近期照片,人脸完整清晰无遮挡,表情自然,正对摄像头,角度无太大偏差。
  • 照片清晰、曝光正常,脸部无过黑、过亮、光晕等情况。
  • 支持的分辨率不超过1920*1080(高*宽),最低满足640*480(高*宽)。推荐短边缩放到720像素,压缩率大于0.9。建议照片的高大于宽,如果传入的照片宽大于高,可能会影响检测效果。
  • 照片需小于1 MB。
  • 支持顺时针旋转90度、180度和270度。
  • 当一张照片中存在多人脸的情况,默认会选取最大的人脸进行验证。
示例:示例

发起认证请求

接口名:InitFaceVerify

服务地址:cloudauth.aliyuncs.com。

请求方法:HTTPS POST和GET。

接口说明:每次开始认证前调用本接口获取CertifyId,用来串联认证请求中的各个接口。

请求参数
名称 类型 是否必选 描述 示例值
SceneId Long 认证场景ID。该ID在控制台创建认证场景后自动生成。 100000****
OuterOrderNo String 您自定义的业务唯一标识,用于后续定位排查问题使用。

值最长为32位长度的字母和数字组合,请确保唯一。

e0c34a77f5ac40a5aa5e6ed20c35****
ProductCode String 认证方案。

唯一取值:PV_FV

PV_FV
Model String 活体检测类型。取值:
  • LIVENESS(默认):动作活体检测。
  • PHOTINUS_LIVENESS:动作活体+炫彩活体双重检测。
说明 仅Android SDK 1.2.6及以上版本、iOS SDK 1.2.4及以上版本支持设置活体检测模式。
LIVENESS
UserId String 您自定义的用户ID,请保持唯一。 12345****
CertType String 证件类型。

当前仅支持身份证。唯一取值:IDENTITY_CARD

说明 该方案中,不验证姓名和证件号码的真实性、一致性。如需验证,请选择实人认证方案。
IDENTITY_CARD
CertName String 您的终端用户的真实姓名。 张三
CertNo String 您的终端用户的证件号码。 33010312345678****
MetaInfo String MetaInfo环境参数。需要通过客户端SDK获取。 {"zimVer":"3.0.0","appVersion": "1","bioMetaInfo": "4.1.0:11501568,0","appName": "com.aliyun.antcloudauth","deviceType": "ios","osVersion": "iOS 10.3.2","apdidToken": "","deviceModel": "iPhone9,1"}
Mobile String 您的终端用户的手机号码。 1304567****
Ip String 您的终端用户的IP。 114.112.xx.xx
FaceContrastPicture String 照片Base64编码。
说明 在下述四种传入图片方式中,选择其中一种:
  • FaceContrastPicture
  • FaceContrastPictureUrl
  • CertifyId
  • OSS
/9j/4AAQSkZJRgABAQAASASBC****
FaceContrastPictureUrl String OSS照片地址,目前只支持已授权OSS照片地址。
说明 在下述四种传入图片方式中,选择其中一种:
  • FaceContrastPicture
  • FaceContrastPictureUrl
  • CertifyId
  • OSS
https://cn-shanghai-aliyun-cloudauth-****.oss-cn-shanghai.aliyuncs.com/verify/****.jpeg
CertifyId String 您的终端用户之前进行活体人脸验证时获取的CertifyId(认证通过),认证时的照片作为比对照片。
说明 在下述四种传入图片方式中,选择其中一种:
  • FaceContrastPicture
  • FaceContrastPictureUrl
  • CertifyId
  • OSS
0bfa7c493f850e5178b9f8613634****
OssBucketName String 已授权OSS空间的Bucket名。
说明 在下述四种传入图片方式中,选择其中一种:
  • FaceContrastPicture
  • FaceContrastPictureUrl
  • CertifyId
  • OSS
cn-shanghai-aliyun-cloudauth-****
OssObjectName String 已授权OSS空间的文件名。
说明 在下述四种传入图片方式中,选择其中一种:
  • FaceContrastPicture
  • FaceContrastPictureUrl
  • CertifyId
  • OSS
verify/****.jpeg
CallbackUrl String 认证结果的回调通知地址,必须以https开头。

平台在完成认证后会回调该地址,并自动添加certifyIdpassedsubcode字段,示例:https://www.aliyun.com?certifyId=xxxx&passed=T&subcode=200

https://www.aliyun.com
CallbackToken String 安全Token,由您自行生成,用于防重复、防篡改校验。

如果设置了该值会在回调地址显示CallbackToken字段。

NMjvQanQgplBSaEI0sL86WnQplB
Crop String 是否允许裁剪人脸图片,默认不允许。
  • T:表示允许剪裁。
  • F:表示不允许剪裁。
说明 若您请求的图片并非来自标准活体检测SDK采集,建议您允许裁剪人脸图片。

开启该功能后,将会对请求的图片先进行人脸裁剪与矫正,完成后会发起请求服务。

T
说明

如果您选择OSS方式传入人脸图片,您必须传入OssBucketNameOssObjectName字段。

OSS入参格式仅支持开通实人认证服务时授权的OSS生成的URL、Bucket和文件名 。关于如何查询授权的OSS,请参见接入流程

如果您选择FaceContrastPicture(照片Base64编码)方式传入人脸照片,请注意检查照片大小,不要传入过大的照片;您可以通过OSS方式上传较大的人脸照片。

返回数据
名称 类型 是否必选 描述 示例值
RequestId String 本次请求的ID。 130A2C10-B9EE-4D84-88E3-5384FF03****
Message String 请求消息的响应信息。 success
Code String 返回码。关于返回码的具体内容,请参见返回Code和Message说明 200
ResultObject.CertifyId String 实人认证唯一标识。 91707dc296d469ad38e4c5efa6a0****
返回Code和Message说明
Code Message 描述
200 success 成功。
400 参数不能为空 参数不能为空。
401 参数非法 非法参数。传入的姓名、身份证号码长度必须符合国家标准且不得包含英文字母等特殊字符。
402 应用配置不存在 应用配置不存在。
404 认证场景配置不存在 认证场景配置不存在,请先在控制台上创建认证场景。
410 未开通服务 未开通OSS产品或未完成OSS读写授权,请登录金融级实人认证控制台完成授权。
411 RAM无权限 需要给RAM账号授予AliyunAntCloudAuthFullAccess的操作权限。
412 欠费中 金融级实人认证或OSS存在欠费,请充值后操作。
414 设备类型不支持 当前移动设备不支持刷脸认证,请更换设备后操作。
415 SDK版本不支持 当前认证SDK版本不支持刷脸认证,请升级SDK后操作。
416 系统版本不支持 当前操作系统版本不支持刷脸认证,请升级系统或更换设备操作。
417 无法使用刷脸服务 自定义比对源的图片人脸特征提取失败,建议更换图片上传。
418 刷脸失败次数过多 当天刷脸认证次数过多,请明天再试。
419 传入图片不可用 图片无法下载、图片内容为空或图片分辨率不符合要求。
420 数据重复 图片传入方式超过1种。 如下:
  • FaceContrastPicture
  • FaceContrastPictureUrl
  • Oss
  • CertifyId
421 传入图片过大 图片超过了1 MB,建议压缩图片或更换图片上传方式。
422 下载图片超时 图片下载超过了3秒,请排查网络后重新操作。
423 状态错误 传入的CertifyId认证状态需要为T(认证通过),您也可以更换其他方式传入图片。
500 系统错误 系统内部错误,请反馈工程师排查。