全部产品
Search
文档中心

ID Verification:删除认证记录

更新时间:Sep 16, 2025

本文介绍如何通过DeleteVerifyResult接口删除ID Verification部分产品方案认证结果中敏感信息和数据。

方案限制

DeleteVerifyResult接口目前仅支持以下方案产生的认证结果:

接口说明

当您完成产品流程后,通过本接口可以删除指定认证流程中的相关认证数据。

控制台信息为异步删除,请3分钟后再行查看。

警告

在删除之前,务必确保相关数据已经保存。一旦删除成功数据将无法恢复,也无法在控制台中查看。

  • 接口名:DeleteVerifyResult

  • 请求方法:POST

  • 传输协议:HTTPS

  • 服务地址:

    说明
    • 内网指的是阿里云同地域产品之间的内部通信网络,如果您的业务服务器部署在阿里云的对应地域,可以通过内网域名访问 ID Verification 服务,以获得更安全、稳定的网络通信质量。

    • ID Verification不同产品方案支持的Region不同,数据之间相互隔离,您需要选择数据所在Reigon下的接口域名,才能成功访问数据。

    新加坡

    • 公网:cloudauth-intl.ap-southeast-1.aliyuncs.com

    • 内网:cloudauth-intl-vpc.ap-southeast-1.aliyuncs.com

    印度尼西亚

    • 公网:cloudauth-intl.ap-southeast-5.aliyuncs.com

    • 内网:cloudauth-intl-vpc.ap-southeast-5.aliyuncs.com

    中国香港

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

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

在线调试和集成

说明

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

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

请求参数

名称

类型

是否必选

描述

示例值

TransactionId

String

Yes

整个认证流程的唯一标识。该值需要调用Initialize接口获取,并用于发起CheckResult接口请求。

e0c34a77f5ac40a5aa5e6ed20c35****

DeleteAfterQuery

String

Yes

删除时是否依赖已获取到对应认证流程中的相关数据。

  • Y:需要。如果需成功删除相关数据,必须已通过CheckResult接口获取处理结果。

  • N:不需要(默认)。通过纯服务端API集成模式时可直接传入N。

Y

DeleteType

String

Yes

用于选择需删除的数据范围。

  • Img:认证流程中获取到的图片数据。对应CheckResult接口idImagefaceImg等所有图片数据。

  • Text:认证流程中图片以外的认证记录数据。对应CheckResult接口的Result.ExtFaceInfoResult.ExtIdInfo中除图片外的数据。

  • All:包括Img和Text数据(默认)。

Img

返回参数

名称

类型

描述

示例值

HTTP Status Code

Integer

HTTP状态码。

200

HTTP Body

Object

无。

无。

└RequestId

String

请求ID。

└Code

String

返回Code

Success

└Message

String

返回Code的详细描述。

success

└Result.TransactionId

String

整个认证流程的唯一标识。

e0c34a77f5ac40a5aa5e6ed20c35****

└Result.DeleteResult

String

删除的结果,取值:

  • Y:成功

  • N:失败

Y

返回Code

Code

Message

描述

200

Success

请求成功。

400

MissingParameter

参数不能为空。

400

InvalidParameter

非法参数。

400

TransactionIdInvalid

无效Transaction id。

403

Forbidden.RAMUserAccessDenied

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

403

Forbidden.AccountAccessDenied

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

403

Throttling.Api

API限流拦截。

500

InternalError

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