删除 Token
删除指定的 Token。
方法
调用方法名为 token_delete,需要提供以下参数:
json
{
"token": "demo_super_token",
"target_token": "target_token_key_or_username"
}target_token为必填,不能为空字符串。
权限要求
只有 SuperToken 可以删除 Token。
target_token 支持两种匹配方式:
token_keyusername
服务端会先按 token_key 匹配;若未命中,再按 username 匹配。
安全保护
- SuperToken 不可删除
- 当
target_token命中 SuperToken 的token_key或username时,服务端会拒绝请求并返回权限错误。
错误语义
- 当
target_token为空时,返回InvalidInput错误。 - 当目标 Token 不存在时,返回
NotFound错误。 - 不再返回
{ "success": false }这类业务失败响应。
成功返回
json
{
"message": "Token xxx deleted successfully by SuperToken",
"rows_affected": 1,
"matched_by": "token_key"
}