刷新令牌
POST
/web/v1/users/self/auth/token/refreshNone使用有效的 refresh token 刷新已过期的 access token,返回新的 access/refresh token 对。
鉴权
Auth Chain: WEB Chain — 无需 JWT(预认证端点) 以下请求头由系统自动注入(前端无需处理):
X-PORTAL-ACCESS-CODE(Nginx),X-Request-Id(Gateway)
请求参数
| Name | Type | Required | In | Description |
|---|---|---|---|---|
request | Object | Yes | body | TokenRefreshRequest 对象(参见请求体 schema) |
成功响应
成功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"
}说明
- Refresh token 为一次性使用;每次刷新都会签发新的 refresh token。
- 限流:每窗口最多 10 次请求。