Skip to content

Endpoint Subscribers ​

Trang này liệt kê 7 endpoint đăng ký nhận việc trong subscriber.api.ts. "Subscriber" là một đăng ký nhận email việc làm theo địa điểm và kỹ năng. Hợp đồng đầy đủ nằm ở tài liệu backend.

Vì sao cần xem kỹ ​

Nhóm này có hai điểm dễ gây nhầm: hook updateSubscriber gọi cùng route với tạo mới, và nhiều hook được khai báo nhưng giao diện không dùng. Bảng dưới ghi rõ từng hook.

Bảng endpoint ​

Hook RTK QueryMethod và pathTham số frontend gửiCache tagNơi dùng
useGetSubscribersQueryGET /subscribers?page=..&limit=..page (1), limit (10), filter, sort dưới dạng tham số tên filter và sortCung cấp từng { Subscriber, id } và LISTChưa có nơi nào dùng
useGetSubscriberQueryGET /subscribers/:ididCung cấp { Subscriber, id }Chưa có nơi nào dùng
useGetSubscriberSkillsQueryPOST /subscribers/skillsKhôngCung cấp { Subscriber, id: "SKILLS" }Chưa có nơi nào dùng
useGetSubscribersByUserQueryGET /subscribers/by-userKhôngCung cấp từng { Subscriber, id } và LISTprofile/pages/email-subscription-page.tsx
useCreateSubscriberMutationPOST /subscribersCreateSubscriberFormData: name, email, locationCode, skillsLàm mất hiệu lực LISTprofile/pages/email-subscription-page.tsx
useUpdateSubscriberMutationPOST /subscribersUpdateSubscriberFormData (bản Partial của form tạo)Làm mất hiệu lực SKILLS và LISTChưa có nơi nào dùng
useDeleteSubscriberMutationDELETE /subscribers/:ididLàm mất hiệu lực LISTprofile/pages/email-subscription-page.tsx

Giao diện thực sự dùng ba thao tác: xem đăng ký của tôi (by-user), tạo và xóa.

Đối chiếu với backend ​

Cả 7 route có trong subscribers.controller.ts; không route nào khai báo giới hạn vai trò, và mọi thao tác chạy trên đăng ký của chính người dùng đang đăng nhập.

ĐiểmChi tiết
updateSubscriberGọi POST /subscribers, route tạo mới. Backend có route sửa riêng là PATCH /subscribers/:id mà frontend không gọi. Hook này chưa được UI dùng, nhưng nếu dùng sẽ tạo một đăng ký mới thay vì sửa
EmailBackend lấy email từ tài khoản đang đăng nhập và không cho ghi đè, dù form frontend vẫn có trường email
Giới hạn số đăng kýGET /subscribers/by-user trả maxAllowed; backend đặt giá trị là 3, frontend đọc từ phản hồi
XóaBackend xóa mềm

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

Form tạo kiểm tra tên (từ 2 ký tự), email, mã địa điểm bắt buộc và ít nhất một kỹ năng. Dạng bản ghi gồm _id, name, email, skills, location, locationCode, createdBy, updatedBy; phản hồi by-user có thêm subscriptions, total, maxAllowed.

Source code liên quan ​

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

Đọc tiếp: Endpoint Skills, Cache và invalidation, Endpoint Notifications.

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