Skip to content

Endpoint Companies ​

Trang này liệt kê 7 endpoint công ty trong company.api.ts: danh sách, chi tiết, quản trị và công ty tuyển nhiều. Hợp đồng đầy đủ nằm ở tài liệu backend.

Vì sao cần xem kỹ ​

Công ty vừa có phần công khai (khách xem danh sách, chi tiết) vừa có phần quản trị (thêm, sửa, xóa). Backend phân quyền theo route, nên cần biết ai gọi được route nào.

Bảng endpoint ​

Hook RTK QueryMethod và pathTham số frontend gửiCache tagNơi dùng
useGetCompaniesQueryGET /companies?page=..&limit=..PaginatedQueryParams: page (1), limit (10), filter, sort; xem Phân trang và lọcCung cấp Companycompanies-page-client.tsx, (dashboard)/admin/companies/page.tsx, user-form.tsx, job-form.tsx
useGetCompanyQueryGET /companies/:idid: stringCung cấp { Company, id }Chưa có nơi nào dùng; trang chi tiết dùng fetchPublicCompanyById
useCreateCompanyMutationPOST /companiesCreateCompanyFormDataLàm mất hiệu lực Companyfeatures/company/hooks/use-company.ts
useUpdateCompanyMutationPATCH /companies/:id{ id, data: UpdateCompanyFormData }Làm mất hiệu lực { Company, id } và Companyfeatures/company/hooks/use-company.ts
useDeleteCompanyMutationDELETE /companies/:idid: stringLàm mất hiệu lực Companyfeatures/company/hooks/use-company.ts
useBulkDeleteCompaniesMutationDELETE /companies/bulkstring[], gửi trong body dạng { ids }Làm mất hiệu lực Company(dashboard)/admin/companies/page.tsx
useGetTopHiringCompaniesQueryGET /companies/top-hiring{ limit? }, thêm ?limit= khi cóCung cấp Companyhome-page-client.tsx, chỉ khi server không gửi sẵn dữ liệu (server gọi fetchPublicTopHiringCompanies)

Danh sách công ty công khai lọc theo tên bằng filter dạng name=/<từ khóa>/i (đã mã hóa), xem buildCompanyListQueryArgs.

Đối chiếu với backend ​

Cả 7 route có trong companies.controller.ts. Theo controller:

RouteAi được gọi
GET /companies, GET /companies/top-hiring, GET /companies/:idKhách và người đã đăng nhập (@OptionalAuth)
PATCH /companies/:idSUPER ADMIN và HR
POST /companies, DELETE /companies/:id, DELETE /companies/bulkChỉ SUPER ADMIN

Route backend frontend không gọi: POST /companies/cleanup-orphaned-logos.

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

Form kiểm tra bằng CompanySchema; quy tắc từng field xem Model Company. Logo được tải lên bằng Endpoint Files trước khi lưu công ty.

Source code liên quan ​

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

Đọc tiếp: Model Company, Endpoint Files, Cache và invalidation.

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