Информация актуальна на момент написания, но через какое-то время может устареть.
Сколько стоит API?
Для уточнения стоимости API Вам необходимо обратиться к Вашему персональному менеджеру или позвонить по телефону:
+7 495 974-64-27 (для Москвы и Подмосковья),
+7 812 458-45-45 (для Санкт-Петербурга),
8 800 100-64-27 (для регионов России).
Как долго будет обрабатываться заявка на приложение?
Заявка на создание приложения должна пройти проверку нескольких отделов, этот процесс может занимать до 20 рабочих дней (это явно указано на форме регистрации). Мы можем предоставить информацию о статусе заявки, но не влиять на скорость/обсуждение/результат.
Как пригласить соискателя на собеседование?
- Для приглашения соискателя на собеседование необходимо получить список коллекций и работодательских состояний откликов/приглашений по вакансии:
GET /negotiations?vacancy_id={vacancy_id}
где vacancy_id - id вакансии, для которой есть отклики
{
"collections": [
{
"id": "response",
"name": "Неразобранные",
"description": "Описание коллекции",
"url": "https://api.hh.ru/negotiations/response?vacancy_id=123456",
// ...
}
// ...
]
// ...
}- Затем, получив url из списка коллекций (параметр
collections[].url), нужно сделать запрос на него
GET /negotiations/{neg_collection_name}?vacancy_id={vacancy_id}
например:
GET /negotiations/response?vacancy_id=123456
В ответ вернутся действия (параметр actions[].url), которые можно совершить с отлкиком, в данном случае из коллекции response.
{
"actions": [
{
"id": "interview",
"enabled": true,
"method": "PUT",
"url": "https://api.hh.ru/negotiations/interview/123456789",
"arguments": [
{
"id": "message",
"required": true,
"required_arguments": []
}
//...
]
//...
}
// ...
]
// ...
}- Далее необходимо выполнить запрос для совершения действия по отклику/приглашению
PUT /negotiations/{action_id}/{negitiation_id}?message={message_text}
например:
PUT /negotiations/interview/123456789?message=new_msg
Также кроме message в arguments[] могут приходить другие аргументы.
Таким образом, пользователь получит сообщение в ответ на свой отклик и будет приглашен на интервью.
- Для создания приглашения необходимо запросить вакансии работодателя, применимые к выбранному резюме. Получить эту информацию можно в списке вакансий работодателя:
GET /employers/{employer_id}/vacancies/active?resume_id={resume_id}
{
"items": [
{
"negotiations_actions": [
{
"id": "phone_interview",
"name": "Телефонное интервью",
"enabled": true,
"method": "POST",
"url": "https://api.hh.ru/negotiations/phone_interview",
"arguments": [
{
"id": "resume_id",
"required": true,
"required_arguments": []
},
{
"id": "vacancy_id",
"required": true,
"required_arguments": []
},
{
"id": "message",
"required": true,
"required_arguments": []
}
//...
]
//...
}
]
// ...
}
]
// ...
}- Выбрать действие, которое необходимо осуществить (параметр
negotiations_actions[].url), и выполнить его, послав запрос
POST /negotiations/{action_id}?resume_id={resume_id}&vacancy_id={vacancy_id}&message={message_text}
например:
POST /negotiations/phone_interview?resume_id=123456&vacancy_id=654321&message=new_msg
Также кроме resume_id, vacancy_id, message в arguments[] могут приходить другие аргументы.
Таким образом, соискатель получит сообщение и будет приглашен на телефонное интервью.
Аналогично можно выполнить любые доступные для работодателя действия с откликом.