身份驗證

登入、權杖刷新、密碼重設、SSO完成——以及透過 API 金鑰進行嘅 API 存取。

呢個分組涵蓋使用者登入:用電郵地址或者用戶名同密碼登入、透過刷新權杖續期工作階段、重設忘記咗嘅密碼,以及完成單一登入(SAML/OIDC)。呢啲端點會回傳一個存取權杖(JWT),呢個權杖透過`Authorization: Bearer <token>`標頭傳送,以及一個刷新權杖,每次使用之後都會被換成新嘅權杖。

對於您自家程式對資料嘅機器存取,請用`https://zentor-app.de/api/v1`下 REST API 嘅 API 金鑰,而唔係用戶登入。Zentor 會按要求開通 API 存取;之後管理員可以喺儀表板「API 金鑰」下建立具有既定權限(scope)嘅金鑰。金鑰透過`Authorization: Bearer <API 金鑰>`標頭或者`X-API-Key`標頭傳送。scope、錯誤代碼,以及安全保管金鑰嘅建議,請參見 API 參考概覽。

登入端點受到保護,可以防止反覆失敗嘅嘗試:喺多次輸入錯誤之後,伺服器會延遲進一步嘅嘗試,並以429 `RATE_LIMIT_EXCEEDED`暫時阻止。

POST/api/auth/loginPOST/api/auth/refreshPOST/api/auth/forgot-passwordPOST/api/auth/reset-passwordPOST/api/auth/sso/exchange
← API 參考