PeekHire 徽标
自动化与开发者

REST API

以编程方式读取和管理活动、申请和用户。

PeekHire REST API 可让你自己的软件处理招聘数据。它是 标准的 HTTPS + JSON API,因此任何能发起网络请求的语言或工具 都可以使用它。

在交互式 OpenAPI 参考中探索每个端点、参数和 schema:

打开 API 参考文档

基础 URL 和版本控制

API 采用版本控制。所有端点都位于 /api/v1 前缀下,因此未来的 变更不会破坏你的集成。

身份验证

每个请求都需要使用作为 bearer token 发送的 API 密钥 进行身份验证:

curl https://your-api-host/api/v1/campaigns \
  -H "Authorization: Bearer YOUR_API_KEY"

切勿将 API 密钥嵌入客户端代码或公开代码仓库中。

你可以访问的内容

v1 API 覆盖核心招聘对象:

  • 招聘活动 — 列出并获取你正在招聘的职位。
  • 申请 — 列出并获取候选人提交的申请。
  • 用户 — 列出并获取你工作区中的成员。

响应为 JSON,并包含你在应用中看到的字段,例如 招聘活动的标题和状态,或申请的阶段和语言。

分页和筛选

列表端点会按页返回结果。使用分页参数浏览大型结果集, 并在支持的地方使用筛选器,只获取你需要的内容。

错误

API 使用标准 HTTP 状态码 — 2xx 表示成功,4xx 表示你的请求存在问题 (例如密钥缺失或无效),5xx 表示意外的 服务器错误。错误响应会包含一条消息,说明出了什么问题。

相关