首页 号码认证服务 API参考 API目录 活体认证 GetCertifyResult - 活体认证结果查询

GetCertifyResult - 活体认证结果查询

通过活体认证token查询最终认证结果。

接口说明

准备工作

请先完成阿里云账号注册、获取阿里云访问密钥、创建认证方案等操作,更多信息,请参见活体认证使用流程

QPS限制

本接口的单用户QPS限制为1000次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
Tokenstring

活体认证Token。

cozS1Z****

返回参数

名称类型描述示例值
object
Codestring

状态码。

OK
Messagestring

状态码的描述。

请求成功
RequestIdstring

请求ID。

8906582E6722
Dataarray

详见结果体内容。

object
MaterialInfostring

认证主体附加信息,默认置null即可。

null
IdentityInfostring

认证主体信息默认置空即可。

null
VerifyDescstring

认证详情描述。取值:

  • 200:认证通过。

  • 205:活体检测存在风险。

  • 206:业务策略限制。

200
VerifyResultstring

认证结果。取值:

  • T:认证结果。

  • F:认证不通过。

T
DeviceTokenstring

设备Token。

McozS1ZWRcRZStlERcZZo_QOytx5jcgZoZJEoRLOsdf****

示例

正常返回示例

JSON格式

{
  "Code": "OK",
  "Message": "请求成功",
  "RequestId": "8906582E6722",
  "Data": [
    {
      "MaterialInfo": "null",
      "IdentityInfo": "null",
      "VerifyDesc": "200",
      "VerifyResult": "T",
      "DeviceToken": "McozS1ZWRcRZStlERcZZo_QOytx5jcgZoZJEoRLOsdf****"
    }
  ]
}

错误码

Http code错误码错误信息描述
400MissingParameterYou must specify the parameter.参数缺失
400InvalidParametersThe specified parameter is not valid.参数无效
403ForbiddenThe user is not authorized to operate on the specified resource.权限校验不通过
500FunctionNotSubscribedYou have not subscribed to the function.未订阅该功能
500InternalErrorAn internal error occurred.内部异常
500OutOfServiceThe account is suspended.账号已停机
500CertifyIdInvalidThe certifyId is invalid.无效的certifyId
500CertifyNotCompleteYou have not completed the certification.认证未完成
500IdentityCertifyNotExistThe identity verification record does not exist.身份认证记录不存在
500SystemErrorA system error occurred.系统异常

访问错误中心查看更多错误码。

Java SDK

您可以通过添加Maven依赖安装阿里云Java SDK。SDK版本会持续更新,具体版本请以OpenAPI页面为准。

JAVA SDK MAVEN坐标

<dependency>
  <groupId>com.aliyun</groupId>
  <artifactId>dypnsapi20170525</artifactId>
  <version>1.0.6</version>
</dependency>
阿里云首页 号码认证服务 相关技术圈