SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场greenhouse

greenhouse

办公与效率

查看项目

更新于 10-16 10:25

技能介绍

Greenhouse 技能用于通过 Greenhouse Harvest API 进行申请人跟踪与招聘相关操作。

一、用途 该技能面向需要访问 Greenhouse 招聘数据的场景，适用于候选人查询、职位与申请管理、录用与面试数据读取，以及创建候选人和添加备注等工作流。

二、认证方式 Greenhouse Harvest 使用 HTTP Basic Auth：以 API token 作为用户名，密码为空。token 通过 Authorization 头传递，格式为 Basic base64(TOKEN:)（注意末尾冒号，表示空密码）。

示例（用 printf 与 base64 动态生成头部）： curl -s "https://harvest.greenhouse.io/v1/candidates?per_page=5" --header "Authorization: Basic $(printf "%s:" "$GREENHOUSE_TOKEN" | base64 -w 0)"

三、环境变量 GREENHOUSE_TOKEN：Harvest API key（v1/v2）。

四、故障排查 若请求失败，可运行 zero doctor check-connector --env-name GREENHOUSE_TOKEN 或 zero doctor check-connector --url https://harvest.greenhouse.io/v1/candidates --method GET。

五、主要端点 基础 URL：https://harvest.greenhouse.io

  1. 列出候选人：GET /v1/candidates，支持分页，per_page 最大 500（默认 100），分页使用 RFC-5988 Link 响应头（rel="next"、rel="prev"、rel="last"）。常用查询参数包括 per_page（1–500）、page（从 1 开始的游标）、created_after / updated_after（ISO-8601 时间戳）、email（精确匹配）、job_id（按关联职位过滤）。
  2. 获取单个候选人：GET /v1/candidates/<candidate-id>。
  3. 创建候选人：POST /v1/candidates，必填字段为 first_name、last_name，常用字段还包括 company、title、emails、phone_numbers、applications。必须携带 On-Behalf-Of: <greenhouse-user-id> 请求头（用于审计），用户 ID 可通过 GET /v1/users 获取。
  4. 列出申请：GET /v1/applications，分页方式同候选人。常用参数：status（active、converted、hired、rejected）、job_id、created_after / created_before / last_activity_after（ISO-8601）、skip_count=true（更快，会从 Link 头去掉 rel="last"）。
  5. 列出职位：GET /v1/jobs，参数：status（open、closed、draft）、department_id、office_id、created_after / updated_after。
  6. 列出职位发布：GET /v1/job_posts，参数如 active=true、live=true。
  7. 列出录用通知：GET /v1/offers，参数 status（draft、approval_sent、approved、sent、sent_manually、accepted、rejected、deprecated）、created_after / updated_after。
  8. 列出已安排面试：GET /v1/scheduled_interviews，参数 application_id、updated_after、starts_after、ends_before、actionable=true（仅返回等待评分反馈的面试）。
  9. 为候选人活动流添加备注：POST /v1/candidates/<candidate-id>/activity_feed/notes，必须携带 On-Behalf-Of 请求头，body 包含 user_id、body、visibility（admin_only、private、public）。

六、常见工作流

  • 按邮箱查找候选人，再读取其活动流：先 GET /v1/candidates?email=...，再用返回的 id 请求 /v1/candidates/<candidate-id>/activity_feed。
  • 拉取某个开放职位的全部申请：GET /v1/applications?job_id=<job-id>&status=active&per_page=500。

七、使用方式与注意事项

  • 所有示例复用同一 Authorization 头；POST body 写入 /tmp/*.json 并通过 -d @/tmp/file.json 传递。
  • Harvest v1/v2 将于 2026 年 8 月 31 日弃用，Greenhouse 正在迁移到基于 OAuth 的 Harvest v3，本技能面向 v1 端点。
  • 速率限制：响应包含 X-RateLimit-Limit、X-RateLimit-Remaining、X-RateLimit-Reset 头，限制按每 10 秒窗口计算；遇到 HTTP 429 时应遵循 Retry-After 头。
  • 所有 POST/PATCH/DELETE 请求都需要 On-Behalf-Of 头，传入操作者的 Greenhouse 用户整数 ID。
  • 分页使用 RFC-5988 Link 头，per_page 最大值为 500。
  • 权限范围：每个 API key 在 Greenhouse Dev Center 创建时配置端点级权限，403 响应通常表示 key 缺少作用域，而非认证失败。

八、适用场景与限制 适用于需要以编程方式读取或写入 Greenhouse 招聘数据的自动化与集成场景。限制包括：仅覆盖 v1 端点、依赖 API key 与端点级权限、写操作需指定 On-Behalf-Of 用户、受速率限制约束，且 v1/v2 将于 2026 年 8 月 31 日弃用。