本文介绍了如何调用InitFaceVerify接口在服务端接入流程中发起认证请求。

接入方式说明

如果采用服务端接入方式,您可以配合SDK调用InitFaceVerify接口发起认证请求,获取CertifyId,唤起客户端上传人脸信息。用户上传人脸信息后,您可以调用DescribeFaceVerify接口查询认证结果

发起认证请求

接口名:InitFaceVerify

服务地址:cloudauth.aliyuncs.com。

请求方法:POST和GET。

传输协议:HTTPS。

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

请求参数
名称类型是否必选描述示例值
SceneIdLong认证场景ID。该ID在控制台创建认证场景后自动生成。关于如何创建认证场景,请参见添加认证场景100000****
OuterOrderNoString客户服务端自定义的业务唯一标识,用于后续定位排查问题使用。值最长为32位长度的字母数字组合,请确保唯一。 e0c34a77f5ac40a5aa5e6ed20c353888
ProductCodeString认证方案。

唯一取值:LR_FR

LR_FR
ModelString活体检测类型。取值:
  • LIVENESS(默认):眨眼动作活体检测。
  • PHOTINUS_LIVENESS:眨眼动作活体+炫彩活体双重检测。
  • MULTI_ACTION:多动作活体检测。当前为眨眼+任意摇头检测。
说明 活体检测模式仅支持运行在Android SDK 1.2.6及以上版本和iOS SDK 1.2.4及以上版本;多动作活体检测模式仅支持运行在Android SDK 1.6.4及以上版本和iOS SDK 1.5.1及以上版本。
LIVENESS
UserIdString客户业务自定义的用户ID,请保持唯一。123456789
CertTypeString证件类型。

当前仅支持身份证,必须传入IDENTITY_CARD

说明 该方案中,不验证姓名和证件号码的真实性、一致性。如需验证,请选择实人认证方案。
IDENTITY_CARD
CertNameString真实姓名。张三
CertNoString证件号码。330103xxxxxxxxxxxx
MetaInfoStringMetaInfo环境参数,需要通过客户端SDK获取,详情请参见App(SDK)接入{"zimVer":"3.0.0","appVersion": "1","bioMetaInfo": "4.1.0:1150****,0","appName": "com.aliyun.antcloudauth","deviceType": "ios","osVersion": "iOS 10.3.2","apdidToken": "","deviceModel": "iPhone9,1"}
重要 该示例仅供参考,实际集成中不能直接应用,具体参考SDK集成说明获取。
MobileString用户手机号码。130xxxxxxxx
IpString用户网络IP。114.xxx.xxx.xxx
CallbackUrlString
认证结果的回调通知地址,必须以https开头。平台在完成认证后会回调该地址,并自动添加certifyIdpassed字段,passed字段值返回的是subcode值,示例:https://www.aliyun.com?callbackToken=1000004826&certifyId=shaxxxx&passed=200
说明 仅当认证完成(包含认证通过和认证未通过)时才会触发回调,若认证中放弃、异常中断或未进行认证均不会通知。建议您收到回调通知时,若有需要可通过查询接口获取认证详情信息。
https://www.aliyun.com
CallbackTokenString安全Token,由您自行生成,用于防重复、防篡改校验。

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

NMjvQanQgplBSaEI0sL86WnQplB
AuthIdString用户授权ID,最大长度为64位字符。92d46b9e9e2d703f2897f350d5bd4149
返回数据
名称类型描述示例值
RequestIdString请求ID。130A2C10-B9EE-4D84-88E3-5384FF039795
MessageString返回信息。success
CodeString返回码。200表示成功,其他表示失败。关于返回码的具体信息,请参见返回Code和Message说明200
ResultObject.CertifyIdString实人认证唯一标识。
警告

CertifyId字段为计费统计字段,为了方便后续核对账单,请您在本地留存该字段信息。

初始化接口返回的认证CertifyId在30分钟有效仅能认证提交一次,请您在有效期内应用,避免重复使用。
91707dc296d469ad38e4c5efa6a0****
返回Code和Message说明
CodeMessage描述
200success成功。
400参数不能为空参数不能为空。
401参数非法非法参数。传入的姓名、身份证号码长度必须符合国家标准且不得包含英文字母等特殊字符。
402应用配置不存在应用配置不存在。
404认证场景配置不存在认证场景配置不存在,请先在控制台上创建认证场景。
410未开通服务未开通OSS产品或未完成OSS读写授权,请登录控制台完成授权。具体操作,请参见授权金融级实人认证访问OSS存储空间
411RAM无权限需要为RAM用户授予AliyunAntCloudAuthFullAccess的操作权限。
412欠费中金融级实人认证或OSS存在欠费,请充值后操作。
414设备类型不支持当前移动设备不支持刷脸认证,请更换设备后操作。
415SDK版本不支持当前认证SDK版本不支持刷脸认证,请升级SDK后操作。
416系统版本不支持当前操作系统版本不支持刷脸认证,请升级系统或更换设备操作。
418刷脸失败次数过多当天刷脸认证次数过多,请明天再试。
500系统错误系统内部错误,请反馈工程师排查。