本文介绍了如何通过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:眨眼动作活体+炫彩活体双重检测。
  • MULTI_ACTION:多动作活体检测。当前为眨眼+任意摇头检测。
说明 活体检测模式仅支持运行在Android SDK 1.2.6及以上版本和iOS SDK 1.2.4及以上版本;多动作活体检测模式仅支持运行在Android SDK 1.6.0及以上版本和iOS SDK 1.5.1及以上版本。
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(照片Base64编码)方式传入人脸照片,请注意检查照片大小,不要传入过大的照片;您可以通过OSS方式上传较大的人脸照片。
说明 您需要在下述四种传入人脸照片方式中,选择其中一种:
  • FaceContrastPicture
  • FaceContrastPictureUrl
  • CertifyId
  • OSS
/9j/4AAQSkZJRgABAQAASASBC****
FaceContrastPictureUrl String 人像地址,公网可访问的HTTP、HTTPS链接。
说明 您需要在下述四种传入人脸照片方式中,选择其中一种:
  • FaceContrastPicture
  • FaceContrastPictureUrl
  • CertifyId
  • OSS
https://cn-shanghai-aliyun-cloudauth-****.oss-cn-shanghai.aliyuncs.com/verify/****.jpeg
CertifyId String 之前实人认证通过的CertifyId,认证时的照片作为比对照片。您需要确保传入CertifyId关联的图片正常存储在授权的OSS Bucket中。
说明 您需要在下述四种传入人脸照片方式中,选择其中一种:
  • FaceContrastPicture
  • FaceContrastPictureUrl
  • CertifyId
  • OSS
0bfa7c493f850e5178b9f8613634****
OssBucketName String 已授权OSS的存储空间(Bucket)名称。如果您选择OSS方式传入人脸照片,您必须传入OssBucketNameOssObjectName参数。OSS请求参数格式仅支持开通实人认证服务时授权的OSS生成的URL、Bucket和文件名。
说明 您需要在下述四种传入人脸照片方式中,选择其中一种:
  • FaceContrastPicture
  • FaceContrastPictureUrl
  • CertifyId
  • OSS
cn-shanghai-aliyun-cloudauth-****
OssObjectName String 已授权OSS存储空间的文件(Object)名称。如果您选择OSS方式传入人脸照片,您必须传入OssBucketNameOssObjectName参数。OSS请求参数格式仅支持开通实人认证服务时授权的OSS生成的URL、Bucket和文件名。
说明 您需要在下述四种传入人脸照片方式中,选择其中一种:
  • 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
AuthId String 用户授权ID,最大长度为64位字符。 92d46b9e9e2d703f2897f350d5bd4149
说明

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读写授权,请登录金融级实人认证控制台完成授权。具体操作,请参见授权金融级实人认证访问OSS存储空间
411 RAM无权限 需要给RAM账号授予AliyunAntCloudAuthFullAccess的操作权限。
412 欠费中 金融级实人认证或OSS存在欠费,请充值后操作。
414 设备类型不支持 当前移动设备不支持刷脸认证,请更换设备后操作。
415 SDK版本不支持 当前认证SDK版本不支持刷脸认证,请升级SDK后操作。
416 系统版本不支持 当前操作系统版本不支持刷脸认证,请升级系统或更换设备操作。
417 无法使用刷脸服务 自定义比对源的图片人脸特征提取失败,建议更换图片上传。
418 刷脸失败次数过多 当天刷脸认证次数过多,请明天再试。
419 传入图片不可用 图片无法下载、图片内容为空或图片分辨率不符合要求。
420 数据重复 图片传入方式超过了一种。 支持以下四种传入人脸照片的方式,必须且只能使用其中一种:
  • FaceContrastPicture
  • FaceContrastPictureUrl
  • Oss
  • CertifyId
421 传入图片过大 图片超过了1 MB,建议压缩图片或更换图片上传方式。
422 下载图片超时 图片下载超过了3秒,请排查网络后重新操作。
423 状态错误 传入的CertifyId认证状态需要为T(认证通过),您也可以更换其他方式传入图片。
500 系统错误 系统内部错误,请反馈工程师排查。