全部产品
Search
文档中心

ID Verification:CheckResult

更新时间:Jan 09, 2026

本文介绍如何通过CheckResult接口查询认证结果。

接口说明

  • 接口名:CheckResult

  • 请求方法:HTTPS POST

  • 接口说明:当您收到回调通知之后,可以在服务端通过该接口获取相应的认证状态和认证资料。

    重要

    ID Verification服务结果默认存储30天,超期系统自动删除,请您在认证结束后的30天内查询认证结果。

  • QPS限量:API独享QPS限量,详情请参见ID Verification服务端API QPS限量说明

  • 服务地址:

    说明
    • 内网访问优势:内网指阿里云同一地域内各产品间的私有通信网络。若您的业务服务器部署于阿里云对应地域,请使用内网域名访问 ID Verification 服务,以获得更安全、稳定的通信质量。 

    • 海外访问优化建议:海外网络环境复杂,建议参考服务端网络耗时分析与优化,优化集成方案,降低网络延迟及请求失败概率。

    中国香港

    • 公网:cloudauth-intl.cn-hongkong.aliyuncs.com

    • 内网:cloudauth-intl-vpc.cn-hongkong.aliyuncs.com

在线调试和集成

说明

在调试和集成前,请确保您已完整阅读使用OpenAPI调试和集成服务端API文档,充分了解API接口在OpenAPI平台的调用方式和SDK及其代码的获取方式。

您可以在OpenAPI Explorer中直接运行本接口进行调试,并生成本接口的SDK代码示例

请求参数

名称

类型

是否必选

描述

示例值

MerchantBizId

String

Yes

您自定义的业务唯一标识,用于后续定位排查问题。支持长度为32位的字母和数字的组合,请确保唯一。

说明

阿里云服务器不会对该字段的值进行唯一性检查。为了更好地跟踪,强烈建议保证字段唯一性。

e0c34a77f5ac40a5aa5e6ed20c35****

TransactionId

String

Yes

整个认证流程的唯一标识。该值需要调用 Initialize 接口获取。

重要

为避免篡改风险,该值必须使用您Initialize接口时服务端存储的TransactionId,不建议使用客户端回调的TransactionId

hksb7ba1b28130d24e015d6********

IsReturnImage

String

No

是否需要返回认证图片资料:

  • Y:需要

  • N:不需要(默认)

Y

返回数据

名称

类型

描述

示例值

HTTP Status Code

Integer

HTTP状态码。

200

HTTP Body

RequestId

String

请求ID。

130A2C10-B9EE-4D84-88E3-5384FF03****

Code

String

返回Code

Success

Message

String

返回Code的详细描述。

success

Result.Passed

String

认证最终结果,取值:

  • Y:通过

  • N:不通过

Y

Result.SubCode

String

认证结果描述。更多信息,请参见ResultObject.SubCode错误码说明

200

Result.ExtFaceInfo

String

活体人脸验证相关结果信息。关于JSON格式,请参见右侧示例。更多信息,请参见ExtFaceInfo

{
  "faceAttack": "N",
  "faceImg": "/9j/4AAQSkZJRgABAQAAAQqviV6oa...",
  "faceQuality": 95.45,
  "faceOcclusion": "N",
   "docVideoUrl": "https://aliyun-cloudauth.oss-aliyuncs.com/******.webm" 
}

ExtFaceInfo

名称

类型

描述

示例值

faceImg

String

采集人脸图片,Base64格式。如在发起接口请求时,参数isReturnImage=Y且扫脸流程顺利完成,则返回此字段。

base64格式

faceAttack

String

采集人脸是否涉及活体攻击:

  • Y:涉及攻击

  • N:不涉及

N

faceQuality

Double

活体人脸质量分数。取值范围0~100。

99.99

faceOcclusion

String

是否有脸部遮挡:

  • Y:有遮挡

  • N:无遮挡

N

docVideoUrl

String

存证OSS下载地址。

说明
  • 存证视频URL有效期15分钟。

  • 在认证完成后30分钟内,可重复查询获取。超过30分钟,系统将自动删除存证视频文件且无法恢复,请及时下载保存。

https://aliyun-cloudauth.oss-aliyuncs.com/******.webm

faceAge

String

人脸预测的参考年龄,可能存在预测失败无法返回的情况。

30

faceGender

String

人脸图片预测的性别,可能存在预测失败无法返回的情况。

  • M:男

  • F:女

M

faceAttackScore

Double

人脸识别算法预测的假脸攻击可能性,分数越高代表假脸的可能性越高。

分值取值:0~100。

80

guardRiskScore

Double

人脸保镖算法预测的设备风险可能性,分数越高代表设备风险越高。

分值取值:0~100。

90

deviceToken

String

设备助手DeviceToken,当SDK完整集成设备助手模块时返回,可通过该Token 查询设备助手服务端接口,获取设备风险详情。

  • 设备助手为付费服务,具体信息,请参考产品计费

  • 此Token 具有7天有效期且不具备唯一性。

e0c34a77f5ac40a5aa5e6ed20c35****

返回Code

HTTP状态码

Code

Message描述

200

Success

请求成功。

400

MissingParameter

参数不能为空。

InvalidParameter

非法参数。

TransactionIdInvalid

无效Transaction id。

403

Forbidden.RAMUserAccessDenied

需要给RAM用户授予AliyunAntCloudAuthFullAccess的操作权限。更多信息,请参见授权RAM用户访问服务

Forbidden.AccountAccessDenied

确保您开通了ID verifycation,并且保证账户未欠费

Throttling.Api

API限流拦截。

404

ProcessNotCompleted

整个认证流程未完成。

500

InternalError

系统内部错误,请反馈工程师排查。

503

ServiceUnavailable

服务不可用,请反馈工程师排查。

ResultObject.SubCode错误码说明

错误码

认证记录是否计费

描述和原因建议

200

认证通过。

205

活体检测存在风险。

206

业务策略限制。

说明

开启安全模式后,会对认证的设备等环境进行安全检测,若检测到可能存在风险,将判定认证结果不通过。您可以提醒用户卸载设备上可能安装的各种多开、分身、虚拟环境等软件或插件,恢复设备系统初始安全环境后重试。