跳转到主要内容
POST
/
api
/
auth
/
refresh
curl --request POST \
  --url https://zeus.agentspro.cn/api/auth/refresh \
  --header 'Content-Type: application/json' \
  --data '{
    "refreshToken": "dGhpcyBpcyBhIHJlZnJlc2ggdG9rZW4..."
  }'

{
  "accessToken": "eyJhbGciOiJFZERTQSIsInR5cCI6IkpXVCJ9...",
  "expiresIn": 3600
}
使用长期有效的 refreshToken（30 天）静默获取新的短期 accessToken（1 小时），无需用户重新登录。

​
使用场景

  • 桌面端/iOS 原生客户端的 accessToken 过期后自动续签
  • 后台自动刷新 token，保持 API 调用不中断
  • 任何在登录时获得了 refreshToken 的原生客户端

​
认证流程

如果 refreshToken 过期或无效，端点返回 401。客户端应清除本地认证状态并跳转到登录页。
​
refreshToken
string
必填
登录时获得的 refreshToken（来自 /api/auth/jwt 或设备授权流程）
​
accessToken
string
新的 JWT accessToken（有效期 1 小时）。使用方式：Authorization: Bearer <accessToken>
​
expiresIn
number
Token 有效期（秒）：3600（1 小时）
curl --request POST \
  --url https://zeus.agentspro.cn/api/auth/refresh \
  --header 'Content-Type: application/json' \
  --data '{
    "refreshToken": "dGhpcyBpcyBhIHJlZnJlc2ggdG9rZW4..."
  }'

{
  "accessToken": "eyJhbGciOiJFZERTQSIsInR5cCI6IkpXVCJ9...",
  "expiresIn": 3600
}