FACE_IDU 支持人脸检索模式,并提供人脸库管理功能。您可以通过 ID Verification 控制台(使用用户 ID)或调用本接口,删除指定的人脸图片。
接口信息
接口名:DeleteFaceRecordV2
请求方法:POST
传输协议:HTTPS
QPS 限制:该 API 对单个租户的请求速率上限为 50 QPS。
服务地址:
说明内网指的是阿里云同地域产品之间的内部通信网络,如果您的业务服务器部署在阿里云的对应地域,可以通过内网域名访问 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
马来西亚(吉隆坡)
公网:
cloudauth-intl.ap-southeast-3.aliyuncs.com内网:
cloudauth-intl-vpc.ap-southeast-3.aliyuncs.com
在线调试和集成
在调试和集成前,请确保您已完整阅读使用OpenAPI文档,充分了解API接口在OpenAPI平台的调用方式和SDK及其代码的获取方式。
您可以在OpenAPI Explorer中直接运行本接口进行调试,并生成本接口的SDK代码示例。
请求参数
名称 | 类型 | 描述 | 是否必填 |
MerchantUserId | String | 用户唯一标识,与 | 是 |
FaceGroupCode | String | 指定人脸库编码;不传则删除该用户在所有人脸库中的人脸数据。 | 否 |
返回参数
名称 | 类型 | 描述 | 示例值 | |
HTTP Status Code | integer | HTTP状态码。 | 200 | |
HTTP Body | RequestId | String | 请求唯一标识,用于问题排查。 | 130A2C10-B9EE-4D84-88E3-5384FF03**** |
Code | String | 返回Code,具体信息请参见服务端返回HTTP状态码说明。 | Success | |
Message | String | 返回Code的详细描述。 | 请求成功 | |
Result.Deleted | String | 删除结果。
| Y | |
Result.DeletedGroupCodes | String | 实际执行删除的人脸库编码列表(以逗号分隔);未传 | 10001 | |