POST/api/auth/forgot-password
Bắt đầu quá trình đặt lại mật khẩu: nếu có tài khoản với địa chỉ email đã cho, tài khoản đó sẽ nhận được email chứa liên kết đặt lại.
Gửi địa chỉ email của tài khoản trong trường `email`. Phản hồi `{"ok":true}` được thiết kế có chủ đích luôn giống nhau – bất kể tài khoản có tồn tại hay không – để không thể dùng endpoint này tìm ra địa chỉ nào đã đăng ký. Mật khẩu mới sau đó được đặt bằng token từ email qua `POST /api/auth/reset-password`. Nếu trường `email` bị thiếu hoặc trống, endpoint trả lời bằng 400 `VALIDATION_ERROR`. Để ngăn chặn lạm dụng, số lượng yêu cầu mỗi địa chỉ IP bị giới hạn (429 `RATE_LIMIT_EXCEEDED`).
Tổng quan
Lệnh gọi: POST /api/auth/forgot-password. Endpoint này thuộc nhóm “Xác thực” trong API của Zentor App. Endpoint này được truy cập công khai và không yêu cầu xác thực. Lệnh gọi có tính idempotent: các lệnh gọi lặp lại với cùng dữ liệu đầu vào trả về cùng một kết quả. Tham số bắt buộc: email (body). Các trường hợp lỗi được tài liệu hóa: 400 VALIDATION_ERROR. Phản hồi mẫu bên dưới cho thấy cấu trúc của một phản hồi thành công ở định dạng JSON.
Xác thực & bảo mật
Không cần xác thực
Lũy đẳng (idempotent): Có
Tham số
email(body, string, bắt buộc)— Địa chỉ email của tài khoảnRequest mẫu
{"email":"user@example.com"}Response mẫu
{"ok":true}Mã lỗi
400 VALIDATION_ERROR — Trường `email` bị thiếu hoặc trống.Hành vi đã được xác minh
Phản hồi là 200 `{"ok":true}` bất kể tài khoản có tồn tại hay không; thiếu trường email trả về 400 `VALIDATION_ERROR`.
Xác thực
POST /api/auth/loginXác thực người dùng bằng địa chỉ email hoặc tên người dùng cùng mật khẩu, và cấp một access token (JWT) cùng một refresh token.POST /api/auth/refreshĐổi một refresh token hợp lệ thành một cặp access token và refresh token mới.POST /api/auth/reset-passwordĐặt mật khẩu mới bằng reset token từ email đặt lại mật khẩu.POST /api/auth/sso/exchangeBước cuối cùng của đăng nhập SSO (SAML/OIDC): đổi mã dùng một lần từ chuyển hướng thành access token và refresh token.