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
200令牌已撤销(无响应体)string
400invalid_request:请求参数缺失或无效 / 令牌不归属认证客户端。参考:RFC 7009 §2.2。service-oauth/internal/handler/dto.OAuthErrorResponse
401invalid_client:客户端认证失败。参考:RFC 7009 §2.2。service-oauth/internal/handler/dto.OAuthErrorResponse

引用的 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 状态