按条件搜索候选人（eHR 申请列表）。

对应 Moka 接口：GET /data/ehrApplications（v1）

参数说明：

• stage：阶段筛选，offer=Offer 阶段 / pending_checkin=待入职 / all=两者。

• email / phone：按邮箱或手机号精确筛选。

• moved_at_start_time / moved_at_end_time：进入当前阶段的时间范围。

• order：DESC（默认，从新到旧）/ ASC。

• limit：返回条数上限（Moka 单页最大 20，这里支持跨页累计上限）。

注意：stage 与 applicationId 至少需要一个定位条件；按 stage 查询且该 阶段当前没有候选人时，Moka 会返回 500，本工具会将其作为「空结果」处理。

获取单个候选人的完整信息。

对应 Moka 接口：GET /data/ehrApplications?applicationId={id}（v1）

参数：

• application_id：候选人申请 ID；支持逗号分隔的多个 ID（如 "81,82,83"）。

返回包含基本信息、教育/工作经历、自定义字段、阶段、职位、Offer、 面试官、内推人、附件等。注意附件与头像 URL 有效期仅 1 小时。

查询某候选人的所有申请记录及状态（一人可投递多个职位）。

对应 Moka 接口：POST /getApplicationStates（candidate/v1，body 传 candidateId）

参数：

• candidate_id：候选人 ID（注意区别于 applicationId）。

返回每条申请的 applicationId、status（in_progress/rejected 等）、 stageName、createdAt。

查询候选人当前所处的招聘阶段。

实现说明：Moka v1 没有独立的单申请阶段查询接口，但候选人详情里自带 stageName，故本工具复用 GET /data/ehrApplications?applicationId={id}。

参数：

• application_id：候选人申请 ID。

查询职位列表。

对应 Moka 接口：GET /jobs/{orgId}（v1）

参数：

• mode：招聘模式，必填。social=社招 / campus=校招。

• org_id：组织标识；留空则使用 .env 中的 MOKA_ORG_ID。

• limit：返回条数上限。

说明：已关闭但未勾选「取消在官网显示」的职位仍会返回；已删除职位不返回。

获取单个职位详情（含自定义字段、招聘流程信息）。

对应 Moka 接口：GET /jobs/{orgId}/{jobId}（v1）

参数：

• job_id：职位 ID。

• org_id：组织标识；留空则使用 .env 中的 MOKA_ORG_ID。

获取某职位的自定义字段。

实现说明：Moka 没有稳定的独立「职位自定义字段定义」读取接口， 但职位详情里自带 customFields，故本工具从 GET /jobs/{orgId}/{jobId} 提取。

参数：

• job_id：职位 ID。

• org_id：组织标识；留空则使用 .env 中的 MOKA_ORG_ID。

获取招聘流程（Pipeline）列表。

对应 Moka 接口：GET /pipelines/getPipelinesList（v2）

返回每个流程的 id、name、hireMode、entryConditions 等。

获取招聘阶段（Stage）信息列表。

对应 Moka 接口：GET /stage/getStagesList（v2）

参数：

• pipeline_id：可选，按指定流程过滤阶段。

返回每个阶段的 id、name、type。

查询部门列表（树形组织架构）。

对应 Moka 接口：GET /departments（v1）

说明：实测返回结构为 {"departments": [...]}（不是通用的 data 字段）。

获取 Offer 自定义字段的定义（社招 / 校招）。

对应 Moka 接口：GET /offers/custom_fields（v1）

说明：实测返回结构为 {"social": [...], "campus": [...]}，分别对应 社招和校招的字段定义（不是通用的 data 字段）。

查询所有人才库。

对应 Moka 接口：GET /talentPool/list（v1）

返回每个人才库的 id、name、hireMode、isPrivate 等（实测直接返回数组）。

查询指定人才库下的候选人（按归档时间范围）。

对应 Moka 接口：GET /talentPool/candidates（v1）

参数（均必填）：

• talent_pool_ids：人才库 ID 列表，如 [666, 888]。

• archived_at_start：归档开始时间，如 "2019-06-01"。

• archived_at_end：归档结束时间，如 "2019-11-01"。