Skip to content

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 QueryMethod và pathTham số frontend gửiCacheNơi dùng
useGetSkillCatalogQueryGET /skills/catalogsearch?, limit? (chỉ thêm vào query khi có)keepUnusedDataFor 86400 giây (1 ngày), không có taghooks/use-skill-catalog.ts, gọi với limit: 200
useGetPopularSkillsQueryGET /skills/popularlimit?keepUnusedDataFor 3600 giây (1 giờ), không có taghooks/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ạngField
SkillCatalogItemlabel, slug, aliases?, category?, description?
PopularSkillskill, count

Source code liên quan ​

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.

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