HeadHunter API

概览

GitHubGitHub

HeadHunter API 是俄罗斯招聘平台 HeadHunter (hh.ru) 提供的官方接口工具集，允许开发者将平台的职位、简历、消息等能力集成到自己的产品中。 ## 核心能力 该 API 基于 REST 架构，数据格式为 JSON，并提供 OpenAPI 规范文件（openapi.yml）供生成客户端代码或查阅文档。主要覆盖以下业务场景： - **上下文与用户信息**：获取和编辑已授权用户（求职者或雇主经理）的信息，以及应用级别的信息。 - **简历管理**：支持雇主端搜索简历、创建和管理保存的简历搜索条件。 - **Webhook 通知**：雇主可以订阅、修改、查看和取消各类事件的通知推送。 - **本地化与站点选择**：支持多语言环境配置及不同地区站点的切换。 ## 授权机制 API 使用 OAuth2 进行授权。开发者需要在 dev.hh.ru 注册应用，根据请求主体的不同，分为四种授权级别： - **匿名请求**：无需授权。 - **应用授权**：以应用身份发起请求。 - **求职者授权**：以求职者身份操作个人数据，无需获取用户的登录名和密码。 - **雇主授权**：以雇主或雇主经理身份执行操作。 ## 注意事项 仓库中明确指出，以雇主经理身份处理回复/邀请消息的相关方法已经废弃，不再支持新的聊天功能，可能导致消息记录显示异常。此外，部分雇主端方法（如简历库的新模型）属于付费 API 服务，需要开通相应的付费权限才能调用。

Q&A

如何开始使用 HeadHunter API？由 AI 生成

首先阅读 API 的总体信息和常见问题，然后在 dev.hh.ru 注册你的应用，并根据需求配置 OAuth2 授权流程。

API 支持哪些类型的授权？由 AI 生成

支持四种类型：匿名请求（无需授权）、应用授权、求职者用户授权和雇主用户授权。

可以通过 API 读取雇主的聊天消息吗？由 AI 生成

原文指出，以雇主经理身份处理回复或邀请消息的方法已经废弃，不支持新的聊天功能，相关消息可能无法正确显示。

在哪里可以找到 API 的接口文档？由 AI 生成

可以通过 OpenAPI 规范文件（openapi.yml）或在线的 Redoc 文档页面查看所有可用接口。