本文介绍了如何通过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 | 否 | 活体检测类型。取值：
说明 仅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编码。
说明 在下述四种传入图片方式中，选择其中一种：
|
/9j/4AAQSkZJRgABAQAASASBC**** |
| FaceContrastPictureUrl | String | 否 | OSS照片地址，目前只支持已授权OSS照片地址。
说明 在下述四种传入图片方式中，选择其中一种：
|
https://cn-shanghai-aliyun-cloudauth-****.oss-cn-shanghai.aliyuncs.com/verify/****.jpeg |
| CertifyId | String | 否 | 您的终端用户之前进行活体人脸验证时获取的CertifyId（认证通过），认证时的照片作为比对照片。
说明 在下述四种传入图片方式中，选择其中一种：
|
0bfa7c493f850e5178b9f8613634**** |
| OssBucketName | String | 否 | 已授权OSS空间的Bucket名。
说明 在下述四种传入图片方式中，选择其中一种：
|
cn-shanghai-aliyun-cloudauth-**** |
| OssObjectName | String | 否 | 已授权OSS空间的文件名。
说明 在下述四种传入图片方式中，选择其中一种：
|
verify/****.jpeg |
| CallbackUrl | String | 否 | 认证结果的回调通知地址，必须以https开头。
平台在完成认证后会回调该地址，并自动添加 |
https://www.aliyun.com |
| CallbackToken | String | 否 | 安全Token，由您自行生成，用于防重复、防篡改校验。
如果设置了该值会在回调地址显示CallbackToken字段。 |
NMjvQanQgplBSaEI0sL86WnQplB |
| Crop | String | 否 | 是否允许裁剪人脸图片，默认不允许。
说明 若您请求的图片并非来自标准活体检测SDK采集，建议您允许裁剪人脸图片。
开启该功能后，将会对请求的图片先进行人脸裁剪与矫正，完成后会发起请求服务。 |
T |
如果您选择OSS方式传入人脸图片，您必须传入OssBucketName和OssObjectName字段。
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 | 描述 |
|---|---|---|
| 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种。 如下：
|
| 421 | 传入图片过大 | 图片超过了1 MB，建议压缩图片或更换图片上传方式。 |
| 422 | 下载图片超时 | 图片下载超过了3秒，请排查网络后重新操作。 |
| 423 | 状态错误 | 传入的CertifyId认证状态需要为T（认证通过），您也可以更换其他方式传入图片。 |
| 500 | 系统错误 | 系统内部错误，请反馈工程师排查。 |