Chuyển tới nội dung chính

API Job Search

Tiền tố /api/v1/job-search. Controller: job-search.controller.ts. Tài liệu sâu: 03-modules/job-search.md (Phase 3).

Công khai (@Public ở cấp class), có ThrottlerGuard (throttler burst 5/giây, sustained 20/10 giây, default 60/phút) và không cache. Tìm kiếm hợp nhất trong cả tin nội bộ (jobs) và tin ngoài (external-jobs).

Danh sách route​

RouteAuthMô tả
GET /api/v1/job-searchCông khaiTìm kiếm hợp nhất tin nội bộ và tin ngoài, có phân trang, lọc theo địa điểm, cấp bậc, hình thức, lương, nguồn
GET /api/v1/job-search/external/:idCông khaiChi tiết một tin ngoài, tôn trọng chính sách hiển thị của nguồn

Tham số tìm kiếm​

Tham sốGiá trịGhi chú
sourceall (mặc định), internal, externalChọn nguồn
sortnewest, oldest, salary_desc, salary_ascSắp xếp
page, limitpage từ 1; limit mặc định 10, tối đa 50job-search.constants.ts
keywordTối đa 100 ký tự
salaryMin, salaryMaxSố nguyên ≥ 0Quy tắc riêng của lương xem tài liệu module

Phản hồi danh sách​

data có dạng { result, meta: { pagination } } (api-overview). Mỗi phần tử IJobSearchItem (job-search-item.interface.ts):

FieldÝ nghĩa
idID tin
sourceTypeINTERNAL hoặc EXTERNAL
sourceKeyKhóa nguồn (tin ngoài)
title, companyName, companyLogoThông tin cơ bản
location, locationCode, isRemoteĐịa điểm
salary hoặc salaryTextLương dạng số (nội bộ) hoặc văn bản (ngoài)
level, formOfWork, skillsThuộc tính
postedAt, endDateThời gian
applyModeINTERNAL (nộp trong DevLink) hoặc EXTERNAL_REDIRECT (chuyển sang nguồn)
applyUrlLiên kết nộp ngoài

Chi tiết tin ngoài​

GET /job-search/external/:id trả IExternalJobDetail. Quy tắc hiển thị theo displayPolicy của nguồn (job-search.service.ts):

Trường hợpKết quả
Nguồn HIDDEN404 như thể không tồn tại
Nguồn LINK_ONLYdescriptionHtml là chuỗi rỗng
Nguồn FULLdescriptionHtml đầy đủ
Tin STALETrả status: "ACTIVE" (STALE là trạng thái nội bộ)
Tin CLOSED hoặc expiresAt đã quastatus: "CLOSED"

applyUrl rơi về sourceUrl nếu không có.

Chi tiết từng route​

Tìm kiếm hợp nhất tin nội bộ và tin ngoài, có phân trang, lọc theo địa điểm, cấp bậc, hình thức, lương, nguồn

Query

TênBắt buộcMô tảVí dụ
(toàn bộ query string)—DTO SearchJobsQueryDto

Query: SearchJobsQueryDto (search-jobs-query.dto.ts)

FieldKiểuBắt buộcValidationVí dụ
keywordstringKhôngIsString, MaxLength(JOB_SEARCH_MAX_KEYWORD_LENGTH)'backend'
locationCodestringKhôngIsString, MaxLength(100)'ho-chi-minh'
levelEJobLevelKhôngIsEnum(EJobLevel)—
formOfWorkEJobFormOfWorkKhôngIsEnum(EJobFormOfWork)—
salaryMinnumberKhôngIsInt, Min(0)10000000
salaryMaxnumberKhôngIsInt, Min(0)50000000
sourceJobSearchSourceKhôngIsIn(JOB_SEARCH_SOURCES)—
sortJobSearchSortKhôngIsIn(JOB_SEARCH_SORTS)—
pagenumberKhôngIsInt, Min(1)—
limitnumberKhôngIsInt, Min(1), Max(JOB_SEARCH_MAX_LIMIT)—

GET /api/v1/job-search/external/:id​

Chi tiết một tin ngoài, tôn trọng chính sách hiển thị của nguồn

  • Auth: Công khai
  • Handler: findExternalJob trong job-search.controller.ts
  • Mã thành công: 200, message = "Get external job by id"

Path params

TênKiểuMô tả
idstring