POST/api/auth/refresh

将有效的刷新令牌交换为一对新的访问令牌和刷新令牌。

在 JSON 请求体中发送最近一次收到的 `refreshToken`。响应包含一个新的 `token` 和一个新的 `refreshToken`。每个刷新令牌只能使用一次,默认有效期为七天;每次调用后请保存新令牌并丢弃旧令牌。 刷新令牌缺失、无效、已过期或已被使用会导致 400 `VALIDATION_ERROR`。此时用户必须通过 `POST /api/auth/login` 重新登录。由于刷新令牌一经使用即失效,客户端应避免并行续期。

概览

调用:POST /api/auth/refresh。该端点属于 Zentor App API 的“身份验证”分组。 该端点可公开访问,无需身份验证。 该调用不是幂等的:每次成功调用都会再次触发该操作。 必填参数:refreshToken (请求体)。 已记录的错误情况:400 VALIDATION_ERROR。 下方的示例响应展示了 JSON 格式的成功响应结构。

身份验证与安全

无需身份验证

幂等: 否

参数

refreshToken(body, string,必填)— 最近一次发出的刷新令牌

请求示例

{"refreshToken":"<来自 /login 的刷新令牌>"}

响应示例

{"ok":true,"token":"<新的 JWT>","refreshToken":"<新的刷新令牌>"}

错误代码

400 VALIDATION_ERROR — 刷新令牌缺失、无效、已过期或已被使用。

已验证的行为

有效的刷新令牌返回一组新的令牌;无效令牌返回 400 `VALIDATION_ERROR`。

身份验证

相关文章

← 身份验证