功能描述
用于删除特定用户的所有访问令牌(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,必选参数;
LibrarySecret: 媒体库密钥,必选参数;
UserIds: 用户身份识别,必选参数,多个 UserId 用
,
分隔,一次最多不超过 10 个,如需超过 10 个请分批次调用;ClientIds: 客户端识别,可选参数,多个 ClientId 用
,
分隔,一次最多不超过 100 个,如需超过 100 个请分批次调用;SessionIds: 会话识别,可选参数,多个 SessionId 用
,
分隔,一次最多不超过 100 个,如需超过 100 个请分批次调用;请求体
空。
响应
响应码
删除成功,返回 HTTP 204 No Content。
响应体
空,无响应体。