Skip to content

Endpoint Auth ​

Trang này liệt kê 15 endpoint xác thực mà frontend khai báo trong auth.api.ts: hook nào gọi, gửi gì, làm mất hiệu lực cache nào và màn hình nào dùng. Hợp đồng đầy đủ nằm ở tài liệu backend.

Vì sao có trang riêng ​

Xác thực đi qua nhiều màn hình (trang, modal, hồ sơ, quản trị) và chạm tới cả state Redux lẫn localStorage. Bảng dưới giúp tìm nhanh endpoint nào do màn hình nào gọi, trước khi sửa một luồng đăng nhập.

NOTE

Cơ chế token và làm mới phiên không lặp lại ở đây, xem Xác thực và Đăng nhập và làm mới token.

Bảng endpoint ​

Mọi endpoint dùng baseApi; địa chỉ gốc là API_BASE_URL.

Hook RTK QueryMethod và pathDữ liệu frontend gửiCache tagNơi dùng
useLoginMutationPOST /auth/loginLoginFormData: email, passwordLàm mất hiệu lực Auth(auth)/login/page.tsx, components/modals/login-form.tsx
useGetMeQueryGET /auth/meKhôngCung cấp Authcomponents/auth-initializer.tsx, (profile)/profile/layout.tsx, overview-page.tsx, settings-page/index.tsx
useRegisterMutationPOST /auth/registerRegisterFormData: name, email, password, confirmPassword, acceptTermsLàm mất hiệu lực Auth(auth)/register/page.tsx, components/modals/register-form.tsx
useVerifyEmailMutationPOST /auth/verifyemail, codeKhônghooks/use-verification.ts
useResendCodeMutationPOST /auth/resend-codeemailKhônghooks/use-verification.ts
useLogoutMutationPOST /auth/logoutKhôngLàm mất hiệu lực Auth, User, Company, Job, Resumecomponents/header.tsx, layout quản trị, layout HR
useRefreshTokenMutationGET /auth/refreshKhông (cookie tự gửi)KhôngChưa có nơi nào gọi; việc làm mới dùng axios trần trong interceptor
useGoogleLoginMutationPOST /auth/google/loginidTokenLàm mất hiệu lực Auth(auth)/login/page.tsx, login-form.tsx
useChangePasswordMutationPOST /auth/change-passwordChangePasswordFormData: currentPassword, newPassword, confirmPasswordLàm mất hiệu lực Authsettings-page/change-password-modal.tsx, (dashboard)/admin/change-password/page.tsx
useSetPasswordMutationPOST /auth/set-passwordnewPasswordLàm mất hiệu lực Authsettings-page/set-password-modal.tsx
useForgotPasswordMutationPOST /auth/forgot-passwordemailKhông(auth)/forgot-password/page.tsx
useResetPasswordMutationPOST /auth/reset-passwordtoken, email, newPasswordKhông(auth)/reset-password/page.tsx
useRequestAccountDeletionMutationDELETE /auth/accountpassword (tùy chọn)Làm mất hiệu lực Auth, Userfeatures/profile/components/account-deletion-dialog.tsx
useCancelAccountDeletionMutationPOST /auth/account/cancel-deletionKhôngLàm mất hiệu lực Auth, Userfeatures/profile/components/pending-deletion-banner.tsx
useCancelAccountDeletionByTokenMutationPOST /auth/account/cancel-deletion-by-tokentokenKhôngaccount/cancel-deletion/page.tsx

Hook useLazyGetMeQuery cũng được export nhưng chưa có nơi nào dùng.

Đối chiếu với backend ​

Cả 15 route đều có trong auth.controller.ts của backend và trường dữ liệu frontend gửi khớp với DTO của backend, trừ các điểm sau:

ĐiểmChi tiết
Field thừa khi đăng ký và đổi mật khẩuFrontend gửi cả confirmPassword (và acceptTerms khi đăng ký). DTO backend không khai báo các field này nên chúng bị loại bỏ im lặng (ValidationPipe có whitelist)
Route backend frontend không gọiPOST /auth/logout-all và GET /auth/sessions
Phản hồi statusCodeForm kiểm tra response.statusCode === 201 cho đăng nhập, Google, đăng ký và quên mật khẩu

Dữ liệu và kiểm tra ​

Màn hìnhKiểm tra ở frontend
Đăng nhậpEmail đúng định dạng, không có khoảng trắng; mật khẩu không rỗng
Đăng kýTên 2 đến 50 ký tự, chỉ chữ cái và khoảng trắng; email chặt hơn đăng nhập; mật khẩu 8 đến 128 ký tự, có chữ hoa, chữ thường, số, ký tự đặc biệt, không có khoảng trắng, không lặp quá 3 ký tự liên tiếp, không chứa các mật khẩu phổ biến; phải xác nhận mật khẩu và đồng ý điều khoản
Đổi và đặt mật khẩuTối thiểu 8, tối đa 128 ký tự, kèm xác nhận

DTO đăng ký của backend chỉ kiểm tra tên, email, mật khẩu không rỗng; DTO đổi mật khẩu yêu cầu mật khẩu mới từ 6 ký tự. Nghĩa là các quy tắc mật khẩu mạnh chỉ được thực thi ở form.

Source code liên quan ​

Hợp đồng đầy đủ: API Auth của backend và controller.

Đọc tiếp: Model User, Xác thực (tính năng), Xử lý lỗi.

Tài liệu kỹ thuật xây dựng theo chuẩn Documentation as Code