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.
Gửi `token` (từ liên kết trong email đặt lại) và `password` mới trong JSON body. Không cần đăng nhập cho bước này. Mật khẩu phải đáp ứng yêu cầu tối thiểu của Zentor App. Khi thành công, server trả lời bằng `{"ok":true}`; sau đó người dùng đăng nhập bằng mật khẩu mới. Token không hợp lệ, đã hết hạn hoặc đã được sử dụng, hoặc mật khẩu không đáp ứng yêu cầu tối thiểu, sẽ dẫn đến 400 `VALIDATION_ERROR`. Token bị tiêu hao sau khi sử dụng thành công; để thay đổi lại, hãy bắt đầu một quy trình mới qua `POST /api/auth/forgot-password`. Endpoint này giới hạn 10 yêu cầu mỗi 15 phút cho mỗi địa chỉ IP. Chỉ truyền token và mật khẩu trong request body qua HTTPS, không bao giờ truyền dưới dạng tham số URL.
Tổng quan
Lệnh gọi: POST /api/auth/reset-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 không có tính idempotent: mỗi lệnh gọi thành công đều kích hoạt lại hành động. Tham số bắt buộc: token (body), password (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): Không
Tham số
token(body, string, bắt buộc)— Reset token từ emailpassword(body, string, bắt buộc)— Mật khẩu mới cần đặtRequest mẫu
{"token":"<Token từ email đặt lại mật khẩu>","password":"MatKhauMoiAnToan!"}Response mẫu
{"ok":true}Mã lỗi
400 VALIDATION_ERROR — Token không hợp lệ, đã hết hạn hoặc đã được sử dụng, hoặc mật khẩu không đáp ứng yêu cầu tối thiểu.Hành vi đã được xác minh
Token không hợp lệ trả về 400 `VALIDATION_ERROR`. Trường hợp thành công (200 `{"ok":true}`) được mô tả theo quy trình đã ghi lại.
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/forgot-passwordBắ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.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.