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

身份驗證

相關文章

← 身份驗證