---
title: "Match My Jobs"
method: GET
path: "/api/v1/candidate/matches"
tags: ["候选人"]
---

# Match My Jobs

`GET /api/v1/candidate/matches`

## Request

- Base URL: `https://api.hipowork.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.hipowork.com/api/v1/candidate/matches`
- Auth: OAuth 2 (password, token URL `/api/v1/auth/oauth/token`)

候选人视角：根据我的简历匹配所有已发布的 active 岗位。
如果指定了 job_id，则直接返回针对该岗位的单岗测算结果。

评分逻辑（0-100，技能为核心）：
- 行业匹配 (0-20)：岗位行业 == 我的行业 → 20分；否则 0
- 技能匹配 (0-50)：岗位要求技能 ∩ 我的技能，按年限比例
- 经验匹配 (0-30)：岗位要求经验 ≤ 我的经验 → 满分，否则按比例

性能优化：匹配结果自动写入 Redis 缓存 30 分钟（1800秒），简历变更时主动清空。

## Query parameters

- `job_id` string, nullable

## Response `200`

Successful Response

- JobMatchResponse: 候选人视角：根据我的简历匹配到的岗位列表
  - `total_matches` integer, required
  - `results` JobMatchResult[], required
    - `rank` integer, required
    - `final_score` number, required
    - `score_breakdown` object, nullable
    - `match_reasons` string[], nullable
    - `job` object, nullable
  - `has_resume` boolean

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/hipowork/apis/hipo-work-ai-recruitment-platform.md) · [All operations](https://skmtc.dev/hipowork/apis/hipo-work-ai-recruitment-platform/llms.txt) · [OpenAPI document](https://skmtc.dev/hipowork/apis/hipo-work-ai-recruitment-platform/revisions/de21a6c57062?raw)