调用InitSmartVerify接口发起增强版活体检测请求。

接口名:InitSmartVerify

服务地址:cloudauth.aliyuncs.com

请求方法:HTTPS POST和GET。

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

请求参数

名称 类型 是否必选 示例值 描述
SceneId Long 100000xxxx 认证场景ID。

您必须先在智能核身控制台创建认证场景,才能获得认证场景ID。更多信息,请参见添加认证场景

OuterOrderNo String e0c34a77f5ac40a5aa5e6ed20c35xxxx 商户请求的唯一标识,由32位字母、数字组合而成。

前面几位字符是商户自定义的简称,中间可以使用一段时间,后段可以使用一个随机或递增序列。

Mode String ACCOUNT_SAFE 增强版活体检测的业务场景类型。取值:
  • ACCOUNT_SAFE:注册安全。
  • DEVICE_SAFE:设备安全。
CertType String IDENTITY_CARD 证件类型。取值:IDENTITY_CARD,表示身份证。
说明 目前仅支持身份证。更多证件类型将陆续开放支持,敬请期待。
CertName String 张三 用户的真实姓名。
CertNo String 330103xxxxxxxxxxxx 用户的证件号码。
MetaInfo String {"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"} MetaInfo环境参数,需要通过客户端SDK获取。

更多信息,请参见Android客户端接入iOS客户端接入

Mobile String 130xxxxxxxx 用户手机号码。
说明 Mode取值为DEVICE_SAFE时,Mobile为非必填字段。
Ip String 114.xxx.xxx.xxx 用户网络IP。
UserId String 12345xxxx 您业务中自定义的用户ID,请保持唯一。
callbackUrl String https://www.aliyun.com 认证结果的回调通知地址,必须以https开头。

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

返回数据

名称 类型 是否必选 示例值 描述
RequestId String 130A2C10-B9EE-4D84-88E3-5384FF039795 请求ID。
Message String success 错误信息。
Code String 200 返回码。取值:
  • 200:成功。
  • 其他值:失败,详见错误码
ResultObject.CertifyId String 91707dc296d469ad38e4c5efa6a0xxxx 认证请求ID,智能核身认证请求的唯一标识。

查询认证结果时,必须传入认证请求ID。

示例

请参见Java SDK调用示例
说明 如果您需要其他语言的SDK代码示例,您可以通过OpenAPI Explorer在线调试工具调试API接口。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

错误码

Code Message 描述
200 success 接口响应成功。
400 参数不能为空 参数不能为空。
401 参数非法 非法参数。传入的姓名、身份证号码长度必须符合国家标准且不得包含英文字母等特殊字符。
404 认证场景配置不存在 认证场景配置不存在,请先在智能核身控制台上创建认证场景。

更多信息,请参见添加认证场景

410 未开通服务 未开通OSS产品或未完成OSS读写授权,请登录智能核身控制台完成授权。
411 RAM无权限 需要为子账号授予AliyunYundunCloudAuthFullAccess的操作权限。
412 欠费中 智能核身或OSS存在欠费,请充值后再进行操作。
500 系统错误 系统内部错误,请提交工单进行反馈,由阿里云工程师协助排查。