刷新令牌
POST
/web/v1/users/self/auth/token/refreshNone使用有效的刷新令牌来更新已过期的访问令牌。返回新的访问令牌/刷新令牌对。
鉴权
Auth Chain: WEB Chain — 无需 JWT(预认证端点) 以下请求头由系统自动注入(前端无需处理):
X-PORTAL-ACCESS-CODE(Nginx),X-Request-Id(Gateway)
请求参数
| Name | Type | Required | In | Description |
|---|---|---|---|---|
request | Object | Yes | body | TokenRefreshRequest 对象(参见请求体结构) |
成功响应
成功200
{
"version": "1.3.0",
"timestamp": 1709337600000,
"success": true,
"code": "2000",
"message": "SUCCESS",
"data": {
"accessToken": "<token>",
"refreshToken": "<token>",
"expiresIn": 3600,
"tokenType": "Bearer"
}
}错误响应
未授权401
{
"success": false,
"code": "4010",
"message": "Invalid or expired token"
}说明
- 刷新令牌为一次性使用;每次刷新都会签发新的刷新令牌。
- 限流:每窗口期最多 10 次请求。