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.
Gửi `refreshToken` nhận được gần nhất trong JSON body. Phản hồi chứa một `token` mới và một `refreshToken` mới. Mỗi refresh token chỉ dùng được một lần và có hiệu lực mặc định bảy ngày; hãy lưu token mới sau mỗi lần gọi và loại bỏ token cũ. Một refresh token bị thiếu, không hợp lệ, đã hết hạn hoặc đã được sử dụng sẽ dẫn đến 400 `VALIDATION_ERROR`. Khi đó người dùng phải đăng nhập lại qua `POST /api/auth/login`. Vì refresh token bị tiêu hao khi sử dụng, client nên tránh làm mới song song.
Tổng quan
Lệnh gọi: POST /api/auth/refresh. 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: refreshToken (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ố
refreshToken(body, string, bắt buộc)— Refresh token được cấp gần nhấtRequest mẫu
{"refreshToken":"<Refresh-Token từ /login>"}Response mẫu
{"ok":true,"token":"<JWT mới>","refreshToken":"<Refresh-Token mới>"}Mã lỗi
400 VALIDATION_ERROR — Refresh token bị thiếu, không hợp lệ, đã hết hạn hoặc đã được sử dụng.Hành vi đã được xác minh
Một refresh token hợp lệ trả về một cặp token mới; token không hợp lệ 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/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/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.