删除特定用户的所有访问令牌

最近更新时间:2025-09-24 15:20:11

我的收藏

功能描述

用于删除特定用户的所有访问令牌(Access Token)。
说明:
调用该接口需要用到媒体库密钥,所以必须在后端调用该接口以保证密钥安全。
必须指定 UserId 参数,因此在创建访问令牌时,如果后续计划主动删除对应的访问令牌,则在创建时也需要指定 UserId。
如指定 ClientId 且不为空字符串,则仅删除指定 UserId(s) 下拥有指定 ClientId 的访问令牌。
如指定 SessionId 且不为空字符串,则仅删除指定 UserId(s) 下拥有指定 SessionId 的访问令牌。
ClientId 与 SessionId 可同时指定为非空字符串,此时仅删除指定 UserId(s) 下同时拥有指定 ClientId 和 SessionId 的访问令牌。

请求

请求示例

DELETE /api/v1/token/{LibraryId}?library_secret={LibrarySecret}&user_id={UserIds}&client_id={ClientIds}&session_id={SessionIds}

请求参数

请求参数
描述
类型
是否必选
LibraryId
媒体库 ID,在媒体托管控制台创建媒体库后获取,请参见 创建媒体库
String
LibrarySecret
媒体库密钥,在媒体托管控制台创建媒体库后获取,请参见 创建媒体库
String
UserIds
用户身份识别,多个 UserId 用,分隔,一次最多不超过10个,如需超过10个请分批次调用
String
ClientIds
客户端识别,多个 ClientId 用,分隔,一次最多不超过100个,如需超过100个请分批次调用
String
SessionIds
会话识别,多个 SessionId 用,分隔,一次最多不超过100个,如需超过100个请分批次调用
String

请求体

空。

响应

响应码

删除成功,返回 HTTP 204 No Content。

响应体

空,无响应体。

错误码

该请求操作无特殊错误信息,常见的错误信息请参见 错误码 文档。