POST /oauth/revoke
OAuth 2.0 令牌撤销端点。成功返回 200 OK(无响应体)。支持撤销 access_token 和 refresh_token。S9-A:客户端认证(RFC 7009 §2.1,Basic / client_secret_post / private_key_jwt;注册为公开客户端者可仅凭 client_id);撤销的令牌须归属认证客户端。参考:RFC 7009 (Token Revocation)。
OAuth None application/x-www-form-urlencoded
请求参数
| 名称 | 位置 | 类型 | 必填 | 默认值 | 示例 | 约束 | 描述 |
token |
formData |
string |
是 |
|
|
|
要撤销的令牌 |
token_type_hint |
formData |
string |
否 |
|
|
|
令牌类型提示: access_token/refresh_token |
client_id |
formData |
string |
否 |
|
|
|
客户端ID(client_secret_post / private_key_jwt / 公开客户端) |
client_secret |
formData |
string |
否 |
|
|
|
客户端密钥(client_secret_post) |
client_assertion |
formData |
string |
否 |
|
|
|
客户端断言 JWT(private_key_jwt) |
client_assertion_type |
formData |
string |
否 |
|
|
|
断言类型(private_key_jwt) |
引用的 Schema
service-oauth/internal/handler/dto.OAuthErrorResponse
OAuth标准错误响应
| 字段 | 类型 | 必填 | 示例 | 约束 | 描述 |
error |
string |
否 |
invalid_request |
|
错误码 |
error_description |
string |
否 |
Missing required parameter |
|
错误描述 |
error_uri |
string |
否 |
https://docs.example.com/errors |
|
错误URI |
i18n_key |
string |
否 |
error.oauth_invalid_request |
|
I18nKey 本地化键(AUTH-46①/U416):协议字段 error/error_description 保持 RFC 6749 §5.2 原样,
本字段是**附加**信息(omitempty;未知错误码不填),供前端/AI 客户端按键确定性渲染文案,
无需解析英文原文。仅出现在 JSON 错误体,不写入 302 错误重定向的查询串。 |
state |
string |
否 |
state-123 |
|
状态 |