本文介绍了App认证方案的接入流程。

发起认证请求

接口名：InitFaceVerify。

服务地址：cloudauth.aliyuncs.com。

请求方法：HTTPS POST和GET。

接口说明：每次开始认证前通过本接口获取CertifyId，用来串联认证请求中的各个接口。

请求参数

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

支持长度为32位的字母和数字的组合，请确保唯一。

 e0c34a77f5ac40a5aa5e6ed20c35****
ProductCode String 是 要接入的认证方案。取值：
  • ID_PRO。使用ID_PRO认证方案，您的用户仅需要做活体认证。
  • ID_PLUS。使用ID_PLUS认证方案，您的用户需要拍摄身份证和活体认证。
    说明 如果您的业务需要同步采集身份证信息，可选择ID_PLUS方案。
ID_PRO
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
CertType String 是 您的终端用户传入的证件类型。
当前仅支持身份证，取值固定为IDENTITY_CARD。
说明 当ProductCode为ID_PLUS时，CertType为非必填字段。
IDENTITY_CARD
CertName String 是 您的终端用户的真实姓名。
说明 当ProductCode为ID_PLUS时，CertName为非必填字段。
张三
CertNo String 是 您的终端用户的证件号码。
说明 当ProductCode为ID_PLUS时，CertNo为非必填字段。
330103************
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 否 您的终端用户的手机号码。 130********
Ip String 否 您的终端用户的IP。 114.100.XX.XX
UserId String 否 您自定义的用户ID，请保持唯一。 123456789
CallbackUrl String 否 认证结果的回调通知地址，必须以https开头。

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

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

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

NMjvQanQgplBSaEI0sL86WnQplB
AuthId String 否 用户授权ID，最大长度为64位字符。 92d46b9e9e2d703f2897f350d5bd4149

返回数据

名称 类型 描述 示例值
RequestId String 请求ID。 130A2C10-B9EE-4D84-88E3-5384FF039795
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 无法使用刷脸服务 当前身份信息无可用比对源，导致此错误的原因请参考认证结果错误码ResultObject.SubCode）201、202和203的描述说明。更多内容，请参见DescribeFaceVerify。
418 刷脸失败次数过多 当天刷脸认证次数过多，请明天再试。
说明 一个身份信息在一天内最多可以认证失败20次，无法调整更多的认证失败次数。
500 系统错误 系统内部错误，请反馈工程师排查。