mindis / api

HeadHunter API: документация и библиотеки

HeadHunter API

По-русски | In english

HeadHunter API — это инструментарий для интеграции HeadHunter в ваш продукт.

Для начала ознакомьтесь с общей информацией по работе API, часто задаваемыми вопросами и с требованиями к использованию логотипов и названию приложений.

Для использования методов, требующих авторизацию пользователя или приложения, вам необходимо зарегистрировать приложение по адресу https://dev.hh.ru и настроить процесс авторизации.

Зарегистрированное приложение может запрашивать у пользователей hh.ru разрешение доступа к их персональным данным, без получения и хранения их логина и пароля.

‼️ Обратите внимание на описание новой модели работы с базой резюме.

Доступ к ряду методов для работодателя платный.

Для уточнения стоимости API необходимо обратиться к Вашему персональному менеджеру или позвонить по телефону: [phone] (для Москвы и Подмосковья),
[phone] (для Санкт-Петербурга),
8 800 100-64-27 (для регионов России).

Содержание

Пометки в документации:

• – актуально для анонимных запросов, не требует авторизации.
• – актуально для запросов от имени приложения, требует авторизацию приложения
• – актуально для запросов от имени соискателя, требует авторизацию пользователя.
• – актуально для бесплатных методов работодателя, требует авторизацию пользователя.
• – актуально для платных методов работодателя, требует авторизацию пользователя.

Общая информация

• Общая информация
• Условия использования сервиса API
• Требования к использованию логотипов
• Требования к названию приложений
• Авторизация
• Кэширование
• Ошибки и коды ответов
• Платный доступ для работодателей к некоторым методом API
• Новая модель работы с базой резюме (поддержка в API)

Контекст

• Информация об авторизованном пользователе или приложении
  • Получение информации об авторизованном пользователе
  • Редактирование информации авторизованного пользователя
  • Получение информации об авторизованном приложении
• Информация о менеджере
  • Рабочие аккаунты менеджера
  • Предпочтения менеджера
• Информация по активным услугам API для платных методов
• Локализация
• Выбор сайта

Резюме

• Поиск резюме
• Сохраненные поиски резюме
  • Список сохраненных поисков резюме
  • Получение единичного сохраненного поиска резюме
  • Создание нового сохраненного поиска резюме
  • Обновление сохраненного поиска резюме
  • Удаление сохраненного поиска резюме
  • Передача сохраненного поиска резюме другому менеджеру
• Просмотр резюме
• Работа с резюме для соискателя
  • Список резюме авторизованного пользователя
  • Создание и редактирование резюме
  • Публикация и продление резюме
  • Удаление резюме
  • История просмотра резюме
  • Информация о статусе резюме и готовности резюме к публикации
  • Списки видимости резюме
• Артефакты (фото, портфолио)
• Поиск по вакансиям, похожим на резюме
• История откликов/приглашений по резюме

Вакансии

• Получение вакансий
  • Поиск по вакансиям
    • Кластеры
    • Описание использованных параметров
  • Получение информации о вакансии
• Поиск по вакансиям, похожим на вакансию
• Отобранные вакансии
• Скрытые вакансии
• Сохраненные поиски вакансий
• Работа с вакансиями
  • Возможные варианты публикации вакансий
  • Публикация вакансий
  • Редактирование вакансий
  • Продление вакансий
  • Список опубликованных вакансий
  • Архивация вакансий
  • Список архивных вакансий
  • Удаление вакансий
  • Список удаленных вакансий
• Статистика по вакансии

Соискатели

• Комментарии к соискателю

Работодатели/компании

• Поиск компаний
• Получение информации о компании

Менеджеры работодателя

• Менеджеры
  • Добавление менеджера
  • Редактирование менеджера
  • Удаление менеджера
  • Справочник менеджеров работодателя
  • Получение информации о менеджере
  • Дневной лимит просмотра резюме для текущего менеджера

Переписка (отклики/приглашения)

• Переписка для соискателя
  • Получение списка откликов
  • Получение списка активных откликов
  • Откликнуться на вакансию
  • Просмотр отклика/приглашения
  • Скрыть отклик
  • Просмотр списка сообщений в отклике
  • Отправка сообщений в отклике
  • Редактирование сообщения в отклике
• Резюме для отклика на указанную вакансию
  • Список резюме, которыми можно откликнуться на указанную вакансию
  • Резюме, сгруппированные по возможности отклика на данную вакансию
• Переписка для работодателя
  • Модель работы, термины и процедуры
  • Общее описание процесса работы с откликами/приглашениями
  • Коллекции и работодательские состояния откликов/приглашений
  • Список откликов/приглашений
  • Просмотр отклика/приглашения
  • Работа с сообщениями по отклику/приглашению для работодателя
  • Приглашение соискателя на вакансию
  • Действия по отклику/приглашению (смена состояния)
  • Статистика по работе с откликами
• Тексты сообщений
• Инструменты оценки

Справочники

• Регионы
• Специализации
• Метро
• Языки
• Отрасли компаний
• Учебные заведения
  • Основная информация об учебных заведениях
  • Факультеты учебных заведений
• Справочники работодателя
  • Адреса
  • Типы и права менеджера
  • Менеджеры работодателя
  • Департаменты
  • Тесты
  • Регионы вакансий
  • Брендированные шаблоны вакансий
• Ключевые навыки
• Прочие справочники

Подсказки (autosuggest, autocomplete)

• Подсказки
  • по названиям университетов
  • по организациям
  • по специализациям
  • по ключевым навыкам
  • по должностям
  • по регионам
  • по ключевым словам поиска вакансий

Банк данных заработных плат

• Отчёты Банка данных заработных плат
  • Оценка заработной платы без прогнозов
• Справочники Банка данных заработных плат
  • Отрасли
  • Уровни специалистов
  • Профобласти и специализации
  • Регионы и города

Поддержка, обратная связь, новости

Общайтесь с нами через twitter @apihhru или через почту [email protected].

Если вы нашли баг в работе HeadHunter API или виджетах, загляните в issues, возможно, про него мы уже знаем и чиним. Если нет, лучше всего сообщить о нём там. Там же вы можете оставлять свои пожелания и предложения.

Если вы нашли проблему на одном из сайтов HeadHunter, напишите в поддержку по сайту или в сообщество поддержки.

За новостями вы можете следить по коммитам в этом репозитории. RSS.

Часто задаваемые вопросы собраны в FAQ.