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`。