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