Endpoint Skills
Trang này liệt kê 2 endpoint kỹ năng trong skill.api.ts: danh mục kỹ năng để gợi ý khi gõ và danh sách kỹ năng phổ biến. Hợp đồng đầy đủ nằm ở tài liệu backend.
Vì sao có thời gian cache riêng
Danh mục kỹ năng ít thay đổi nhưng được dùng ở nhiều ô nhập. Vì vậy hai endpoint này không dùng cache tag mà đặt keepUnusedDataFor: danh mục giữ 1 ngày, kỹ năng phổ biến giữ 1 giờ.
Bảng endpoint
| Hook RTK Query | Method và path | Tham số frontend gửi | Cache | Nơi dùng |
|---|---|---|---|---|
useGetSkillCatalogQuery | GET /skills/catalog | search?, limit? (chỉ thêm vào query khi có) | keepUnusedDataFor 86400 giây (1 ngày), không có tag | hooks/use-skill-catalog.ts, gọi với limit: 200 |
useGetPopularSkillsQuery | GET /skills/popular | limit? | keepUnusedDataFor 3600 giây (1 giờ), không có tag | hooks/use-popular-skills.ts, gọi với limit 10 |
useSkillCatalog đổi mỗi mục thành { label, value } để dùng cho ô chọn nhiều và ô gợi ý tìm kiếm.
Đối chiếu với backend
Cả hai route có trong skills.controller.ts và được gắn @Public(), nên khách cũng gọi được. Các route còn lại của controller (POST, GET, GET :id, PATCH, DELETE, DELETE bulk) chỉ cho SUPER ADMIN và frontend không gọi.
Dữ liệu
| Dạng | Field |
|---|---|
SkillCatalogItem | label, slug, aliases?, category?, description? |
PopularSkill | skill, count |
Source code liên quan
src/features/skill/redux/skill.api.ts: khai báo endpoint và thời gian cachesrc/features/skill/schemas/skill.schema.ts: kiểu dữ liệusrc/hooks/use-skill-catalog.ts:useSkillCatalogsrc/hooks/use-popular-skills.ts:usePopularSkillssrc/components/ui/search-suggest-input.tsx: ô gợi ý dùng cả hai
Hợp đồng đầy đủ: API Skills của backend và controller.
Đọc tiếp: Cache và invalidation, Chiến lược cache, Tìm kiếm việc làm.
