Endpoint Job Search
Trang này liệt kê hai endpoint tìm kiếm hợp nhất trong job.api.ts và các lời gọi fetch phía server dùng cùng địa chỉ. Dành cho developer cần biết trang công khai lấy dữ liệu bằng đường nào.
Vì sao có cả hook lẫn fetch
Trang /jobs phải có dữ liệu ngay khi render trên server để có nội dung cho công cụ tìm kiếm và để người dùng không thấy trang trống. Vì vậy lần tải đầu dùng fetch phía server. Khi người dùng đổi bộ lọc, trình duyệt gọi lại bằng RTK Query. Hai đường này gọi cùng route backend nhưng độc lập về cache; xem Chiến lược cache.
Bảng endpoint
| Hook RTK Query | Method và path | Tham số frontend gửi | Cache tag | Nơi dùng |
|---|---|---|---|---|
useSearchJobsQuery | GET /job-search | JobSearchParams truyền qua params của Axios: page, limit, sort luôn có; keyword, locationCode, level, formOfWork, salaryMin, salaryMax, source khi người dùng chọn | Cung cấp Job | hooks/use-job-list.ts, jobs/jobs-page-client.tsx |
useGetExternalJobQuery | GET /job-search/external/:id | id: string, được encodeURIComponent | Không | Chưa có nơi nào dùng; trang chi tiết dùng fetchPublicExternalJobById |
Cách đổi trạng thái trong URL thành JobSearchParams nằm ở Phân trang và lọc.
Trong jobs-page-client.tsx, useSearchJobsQuery còn được gọi lần hai với skip: !isMobileFilterOpen để đếm số kết quả khi người dùng chỉnh bộ lọc trong ngăn lọc trên điện thoại, trước khi bấm áp dụng.
Lời gọi fetch phía server
Các hàm trong src/lib/utils/public-content.ts dùng fetch với next: { revalidate }: 60 giây cho việc làm, 3600 giây cho việc làm bên ngoài (xem Chiến lược cache). Khi lỗi hoặc mã không thành công, chúng trả null, không ném lỗi.
| Hàm | Đường dẫn gọi | Nơi dùng |
|---|---|---|
fetchPublicJobSearch | /job-search?<query> | (main)/jobs/page.tsx |
fetchPublicExternalJobById | /job-search/external/:id | (main)/jobs/external/[id]/page.tsx |
fetchPublicJobById | /jobs/:id | (main)/jobs/[id]/page.tsx |
fetchPublicJobs | /jobs?<query> | sitemap.ts, (main)/page.tsx, (main)/companies/[id]/page.tsx |
fetchPublicJobSearch, fetchPublicExternalJobById và fetchPublicJobById được bọc cache() của React để generateMetadata và trang cùng một lần render chỉ gọi một lần.
Đối chiếu với backend
Hai route có trong job-search.controller.ts (GET và GET external/:id). Theo job-search.service.ts:
| Hành vi backend | Hệ quả ở frontend |
|---|---|
Tin của nguồn có chính sách HIDDEN trả 404 | Trang chi tiết gọi notFound() vì fetchPublicExternalJobById trả null |
Tin của nguồn LINK_ONLY trả descriptionHtml rỗng | Giao diện dẫn người dùng tới trang gốc |
Tin hết hạn trả status: CLOSED dù chưa được đồng bộ | Giao diện ẩn nút ứng tuyển và hiện thông báo đóng |
applyUrl lấy từ sourceUrl khi tin không có applyUrl | Nút ứng tuyển vẫn có đích |
limit tối đa 50, keyword tối đa 100 ký tự | Frontend không tự cắt; xem Phân trang và lọc |
Source code liên quan
src/features/job/redux/job.api.ts:searchJobs,getExternalJobsrc/lib/utils/public-content.ts: các hàmfetchPublic*src/lib/utils/public-listing.ts:buildJobSearchParams,toJobSearchQueryStringsrc/features/job/schemas/job-search.schema.ts: kiểu tham số và kết quảsrc/app/[locale]/(main)/jobs/page.tsx: tải dữ liệu đầu trên server
Hợp đồng đầy đủ: API Job Search của backend và service.
Đọc tiếp: Model JobSearchItem, Tìm kiếm và lọc việc làm, Endpoint Jobs.
