Xác thực

Đăng nhập, làm mới token, đặt lại mật khẩu, hoàn tất SSO – và truy cập API bằng khóa API.

Nhóm này bao gồm đăng nhập của người dùng: đăng nhập bằng địa chỉ email hoặc tên người dùng và mật khẩu, làm mới phiên bằng refresh token, đặt lại mật khẩu đã quên, và hoàn tất đăng nhập single sign-on (SAML/OIDC). Các endpoint trả về một access token (JWT), được gửi trong header `Authorization: Bearer <token>`, và một refresh token được thay bằng token mới mỗi khi sử dụng.

Để truy cập dữ liệu của bạn bằng máy từ các chương trình riêng, hãy dùng một khóa API cho REST API tại `https://zentor-app.de/api/v1` thay cho đăng nhập người dùng. Zentor kích hoạt quyền truy cập API theo yêu cầu; sau đó quản trị viên tạo các khóa với quyền hạn (scope) xác định trong bảng điều khiển tại “Khóa API”. Khóa được gửi trong header `Authorization: Bearer <khóa API>` hoặc header `X-API-Key`. Các scope, mã lỗi và lời khuyên về lưu trữ an toàn được mô tả trong tổng quan của API Reference.

Các endpoint đăng nhập được bảo vệ chống các lần thử thất bại lặp lại: sau nhiều lần nhập sai, server sẽ làm chậm các lần thử tiếp theo và tạm thời khóa với 429 `RATE_LIMIT_EXCEEDED`.

POST/api/auth/loginPOST/api/auth/refreshPOST/api/auth/forgot-passwordPOST/api/auth/reset-passwordPOST/api/auth/sso/exchange
← Tài liệu tham khảo API