NATSoauth.token.revoke吊销访问令牌

Try it 面板需要启用 JavaScript。

吊销访问令牌或刷新令牌；支持应用侧（自吊销）与用户侧（经授权记录撤销的级联）。

Request Payload

消息格式：JSON

Name	Data Type	Required	Description
token	string	Yes	要吊销的令牌
tokenTypeHint	string	No	access_token / refresh_token（可选）
clientId	string	No	发起吊销的客户端标识（校验令牌归属）

type RequestBody = {
  /** 要吊销的令牌 */
  token: string
  /** access_token / refresh_token（可选） */
  tokenTypeHint?: string
  /** 发起吊销的客户端标识（校验令牌归属） */
  clientId?: string
}

{
  "token": "at_o_77b2ce14d9f0a358",
  "tokenTypeHint": "access_token",
  "clientId": "cli_9f2ka81mdx"
}

Response Payload

回复使用统一信封 {id, code, messages, result}，其 result：

Name	Data Type	Required	Description
revoked	boolean	Yes	是否吊销成功

type ResponseBody = {
  /** 是否吊销成功 */
  revoked: boolean
}

{
  "revoked": true
}

Response Code

回复使用统一信封 {id, code, messages, result}，其 code 字段：

code	Meaning	Notes
0	成功	吊销访问令牌

Examples

{ "token": "at_o_77b2ce14d9f0a358", "tokenTypeHint": "access_token", "clientId": "cli_9f2ka81mdx" }

{
  "id": "01JD8SWVJU9W6XT",
  "code": 0,
  "messages": [],
  "result": { "revoked": true }
}

Remarks

令牌不属于该 clientId 时拒绝（共享状态冲突码）；令牌本已无效时幂等返回 revoked: true。jwt 形态令牌不支持即时吊销——撤销走授权记录（oauth.grant.revoke）。