POST/api/v1/auth/refresh刷新会话令牌

Try it 面板需要启用 JavaScript。

以刷新令牌换发新的会话令牌与刷新令牌（旋转式，旧刷新令牌立即失效）。

Request

Headers

Name	Data Type	Required	Description
Content-Type	string	Yes	请求体内容类型（默认值 "application/json"）

type RequestHeaders = {
  /** 请求体内容类型，默认值 "application/json" */
  Content-Type: string
}

{
  "Content-Type": "application/json"
}

Body

Name	Data Type	Required	Description
refreshToken	string	Yes	登录时签发的刷新令牌

type RequestBody = {
  /** 登录时签发的刷新令牌 */
  refreshToken: string
}

{
  "refreshToken": "rt_46a9c7e015283d5b"
}

Response

Body

Name	Data Type	Required	Description
sessionToken	string	Yes	新会话令牌
refreshToken	string	Yes	新刷新令牌（旧令牌已失效）
expiresAt	string	Yes	新会话过期时间

type ResponseBody = {
  /** 新会话令牌 */
  sessionToken: string
  /** 新刷新令牌（旧令牌已失效） */
  refreshToken: string
  /** 新会话过期时间 */
  expiresAt: string
}

{
  "sessionToken": "st_9e2b1f47c83d5a72",
  "refreshToken": "rt_71b3de50492c6a1f",
  "expiresAt": "2026-11-13T09:00:00Z"
}

HTTP Code

HTTP Status	Meaning	Notes
200	成功	返回新令牌对
401	刷新令牌无效	已过期、已使用或已注销

Response Code

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

code	Meaning	Notes
0	成功	返回新令牌对
2003	刷新令牌无效	已过期、已旋转使用或所属会话已注销

Examples

POST /api/v1/auth/refresh
Content-Type: application/json

{
  "refreshToken": "rt_46a9c7e015283d5b"
}

{
  "id": "01JD8SH8V3N0M4A3",
  "code": 0,
  "messages": [],
  "result": {
    "sessionToken": "st_9e2b1f47c83d5a72",
    "refreshToken": "rt_71b3de50492c6a1f",
    "expiresAt": "2026-11-13T09:00:00Z"
  }
}

Remarks

刷新令牌一次性使用；旋转后旧令牌立即作废，重复使用按无效处理（2003）。