刷新访问令牌

使用登录响应中的 refreshToken 换取一组新的 access_token 与 refresh_token。

轮换与重试规则：

成功后必须持久化响应中的新 refresh_token，并在后续刷新中使用它。

旧 refresh_token 在轮换后的短暂并发重试宽限期内（默认 20 秒，可由服务端配置调整）重复提交时，返回与首次刷新完全相同的一组新令牌；宽限期结束后旧令牌失效。

appId 为可选的令牌归属断言；提供时必须与该 refreshToken 绑定的应用一致。

调用方应立即切换到新的 access_token。为避免并发请求中断，服务端可能让上一张仍有效的访问令牌额外保留短暂过渡期（默认最多 300 秒，且不超过其原有效期）。

有效期：

首次签发的 refresh_token 最长有效 30 天。每次成功轮换后的新令牌有效期最多为 7 天，且不会超过首次签发时间起算的 30 天绝对上限。

access_token 的剩余有效期以响应中的 expires_in（秒）为准。

失败处理：

收到 401 表示刷新令牌无效、失效、归属不匹配或应用已禁用；调用方应重新登录。

收到 503 表示令牌轮换状态暂不可用；调用方可使用同一旧 refreshToken 在短暂退避后重试。

使用方式：
获取新 access_token 后，业务请求通过请求头携带：Authorization: Bearer <access_token>

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢201

application/json

刷新令牌成功

Bodyapplication/json

示例

{
    "code": 0,
    "message": "success",
    "data": {
        "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
        "expires_in": 7200,
        "refresh_token": "v1.Qx3m...new-opaque-token...9Lp",
        "refresh_expires_in": 2592000
    }
}

🟠400

🟠401

🔴500

🔴503

请求参数

请求示例代码

返回响应