Skip to content
Permalink
master
Switch branches/tags
Go to file
 
 
Cannot retrieve contributors at this time

Сохраненные поиски резюме

employer with paid access : Методы доступны только для работодателей и требуют наличия платного доступа для работодателя

Сохраненный поиск (автопоиск) — это сохраненный набор параметров поиска, по которому можно отслеживать новые резюме по заданному запросу. Помимо сохранения параметров поисковых запросов, автопоиск позволяет получать оповещения о новых результатах поиска. Для удобства автопоиску можно задавать имя.

Список сохраненных поисков резюме

GET /saved_searches/resumes

Дополнительно можно указать стандартные параметры пагинации page и per_page. По умолчанию per_page - 5, максимальное значение - 10.

Ответ

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

{
  "per_page": 0,
  "page": 0,
  "pages": 1,
  "found": 2,
  "items": [
    {
      "id": "609535",
      "name": "Managers in Moscow",
      "created_at": "2015-01-01T13:12:17+0400",
      "subscription": true,
      "items": {
        "count": 55,
        "url": "https://api.hh.ru/resumes?order_by=publication_time&saved_search_id=123456&text=manager&area=1"
      },
      "new_items": {
        "count": 15,
        "url": "https://api.hh.ru/resumes?order_by=publication_time&saved_search_id=123456&text=manager&area=1&last_used=2015-11-12T18%3A06%3A04%2B0300"
      }
    }
  ]
}

Каждый элемент коллекции содержит следующую информацию:

название тип комментарий
id строка идентификатор
name строка название
subscription логический подключена ли подписка
items объект данные о найденных резюме
new_items объект данные о найденных резюме, появившихся с момента последнего просмотра автопоиска

Объекты items и new_items содержат следующие поля:

название тип комментарий
count int количество результатов сохраненного поиска
url строка ссылка на результаты сохраненного поиска, присутствует, если активирован доступ к поиску резюме

!! Внимание: счетчик new_items.count обновляется раз в час. Из-за этого реальное количество новых найденных резюме может расходиться со значением этого счетчика.

Ошибки

  • 403 Forbidden - запрос не от работодателя

Получение единичного сохраненного поиска резюме

GET /saved_searches/resumes/{id}

где id – идентификатор автопоиска.

Ответ

Успешный ответ приходит с кодом 200 OK и содержит единичный объект автопоиска, аналогичный объектам в списке автопоисков резюме.

Ошибки

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

Создание нового сохраненного поиска резюме

Для создания автопоиска неоходимо отправить запрос:

POST /saved_searches/resumes

со следующими параметрами в теле запроса:

  • параметры поиска резюме. Соответствуют параметрам, передаваемым в поиск резюме /resumes

Ответ

В случае успешного создания вернется ответ 201 Created с заголовком Location, указывающим на созданный автопоиск:

Location: /saved_searches/resumes/123

где 123 - id созданного автопоиска

Ошибки

  • 403 Forbidden - запрос не от работодателя
  • 400 Bad request - параметры указаны неверно или в неправильном сочетании

Обновление сохраненного поиска резюме

У сохраненного поиска возможно изменить имя и статус подписки, для этого необходимо послать

PUT /saved_searches/resumes/{id}

где id - идентификатор сохраненного поиска.

За один заход можно изменять только имя (параметр name) или только статус подписки (параметр subscription=false)

Ответ

В случае успешного обновления адреса вернётся HTTP-статус 204 No Content.

Ошибки

  • 400 Bad Request - не передан ни один из возможных параметров, либо передан невалидный параметр
  • 403 Forbidden - запрос не от работодателя
  • 404 Not Found - автопоиск не найден или не принадлежит текущему пользователю
  • 409 Conflict - при попытке изменить оба параметра сразу

Удаление сохраненного поиска резюме

Для того, чтобы удалить автопоиск, необходимо выполнить запрос

DELETE /saved_searches/resumes/{id}

где id - идентификатор автопоиска.

Ответ

В случае успешного обновления адреса вернётся HTTP-статус 204 No Content.

Ошибки

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

Передача сохраненного поиска резюме другому менеджеру

Для того, чтобы передать автопоиск другому менеджеру, необходимо выполнить запрос

PUT /saved_searches/resumes/{saved_search_id}/managers/{manager_id}

где:

Ответ

В случае успешного обновления адреса вернётся HTTP-статус 204 No Content.

Ошибки

  • 403 Forbidden - запрос не от работодателя
  • 404 Not Found - автопоиск не найден или не принадлежит текущему пользователю
  • 404 Not Found - менеджер не найден Тело ответа может содержать подробности, позволяющие понять причину ошибки(saved_search_not_found или manager_not_found)