刷新访问令牌

POST/v2/auth/token/refresh

用 refresh_token 换取新的 access_token，同时轮换 refresh_token。

刷新成功后旧 refresh_token 立即进入 5 秒宽限期，期间并发的刷新请求会返回同一组新令牌（幂等），避免移动端并发刷新导致登录态丢失。

免鉴权 api.demo.acme-cloud.dev

请求体

application/json

refresh_token 必填

string

上一次登录或刷新返回的 refresh_token

响应

2 种状态

200 OK

响应示例

{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJ1c2VyXzdmM2EyMSJ9.refreshed",
  "refresh_token": "rt_2f90aa31c7de4b0f9e12",
  "token_type": "Bearer",
  "expires_in": 7200
}

代码示例

cURL

curl -i -X POST 'https://api.demo.acme-cloud.dev/v2/auth/token/refresh' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "refresh_token": "rt_8c41d0ecb9a24f3d8a6b"
}'

注意事项

refresh_token 一次性使用，客户端需保证单飞（single-flight），并发刷新请做本地互斥。