employer_methods.md

Платный доступ для работодателей к некоторым методам API

Начиная с 16 июля 2018 года, некоторые методы API HH для работодателей стали платными.

Такие методы отмечены в оглавлении лейблом

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

Обратите внимание, что при работе приложения от имени нескольких учетных записей работодателей (employer_id), у каждой учетной записи работодателя должен быть доступ к платным методам API. Проверить информацию о подключенных услугах работодателя можно с помощью специального метода.

В случае запроса платного метода без купленного доступа будет выдана ошибка 403 Forbidden.

Проверить, есть ли доступ к платному методу

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

Запрос

GET /employers/{employer_id}/managers/{manager_id}/method_access

где:

• employer_id - идентификатор работодателя, который можно узнать в информации о текущем пользователе.
• manager_id - идентификатор менеджера, который можно узнать в информации о текущем пользователе.

Вернутся все существующие группы методов с информацией о доступе к ним.

В настоящее время существуют следующие группы:

1. Наличие доступа к методам:
   • Просмотр резюме
   • Работа с откликами
   • Переписка
2. Наличие доступа к методам:
   • Поиск резюме
   • Cохраненные поиски резюме
3. Наличие доступа к просмотру резюме, у которого есть отклик или приглашение
4. Наличие доступа к просмотру резюме для резюме найденных через поиск по базе

!! Внимание произошли изменения в доступе к контактной информации. Прочитайте внимательно информацию про поконтактный доступ к резюме

Ответ

Успешный ответ приходит с кодом 200 OK и содержит тело:

{
    "items": [
        {
            "id": "3",
            "description": "Наличие доступа к просмотру резюме, у которого есть отклик или приглашение",
            "access": {
                "has_access": true
            }
        },
        {
            "id": "4",
            "description": "Наличие доступа к просмотру резюме",
            "access": {
                "has_access": false
            }
        },
        ...
    ]
}

Каждый элемент массива items содержит в себе описание группы методов.

Имя	Тип	Описание
id	string	идентификатор группы методов
description	string	описание группы методов
access.has_access	boolean	есть ли доступ к группе методов

Ошибки

• 403 Forbidden – если текущий пользователь - не работодатель.
• 404 Not Found – если указанный работодатель или менеджер не найден.