SuperAPI AI 工具集

ashby

办公与效率

查看项目

更新于 10-16 02:36

技能介绍

用途:该技能封装 Ashby 招聘系统(ATS)的 API,用于申请人跟踪与招聘数据操作。当用户提到 Ashby、ATS、申请人跟踪、候选人、职位申请、招聘等关键词时使用。

主要能力:支持列出与搜索候选人(candidate.list、candidate.search)、列出申请(application.list)、列出职位(job.list)、列出招聘需求(opening.list)、列出职位发布(jobPosting.list)、获取公开招聘板职位(GET /posting-api/job-board/{JOB_BOARD_NAME})、列出项目(project.list),以及给候选人添加备注(candidate.createNote)。列表接口支持分页与增量同步。

使用方式:所有请求使用 HTTP Basic Auth,API 密钥作为用户名、密码留空,例如 curl 中传 -u "$ASHBY_TOKEN:"。API 为 RPC 风格,端点通常为 POST /resource.method,参数放在 JSON 请求体中,并需带上两个 JSON 头:-H "Accept: application/json; version=1" -H "Content-Type: application/json"。基础 URL 为 https://api.ashbyhq.com。环境变量为 ASHBY_TOKEN。分页时读取返回的 results、moreDataAvailable 和 nextCursor,将 nextCursor 作为 cursor 继续请求;支持 syncToken 的端点可保存末页返回的 syncToken 用于下次增量拉取。

适用场景:按邮箱或姓名查找候选人、拉取某职位的活跃申请、同步候选人/申请/职位数据、读取公开招聘板职位、为候选人添加备注等招聘自动化流程。

限制:API 密钥为长期有效,仅应在服务端代码中使用;密钥具有端点级权限,应申请最小权限。缺少密钥返回 401,密钥错误、停用或无端点权限返回 403,missing_endpoint_permission 表示密钥有效但需相应权限。机密职位/项目和候选人私有字段需在 Ashby 中显式授权。增量同步若返回 incremental_sync_too_large 或 sync_token_expired,需丢弃 syncToken 并执行完整同步。公开招聘板端点不使用 API 密钥认证。