Получение вакансий

GET /vacancies

Возвращает список вакансий компании, к которой относится токен. Это метод чтения: создавать и редактировать вакансии через этот маршрут нельзя.

curl 'https://openapi.uhead.ru/prod/external/v1/vacancies?page=1&limit=20' \
  --header "Authorization: Bearer $UHEAD_API_TOKEN"

Параметры запроса

Формат ответа

items содержит вакансии, pagination — номер страницы, размер страницы и общее количество записей. Ниже приведён условный пример ответа.

{
  "items": [{
    "id": 101,
    "name": "Продавец-консультант",
    "archived": false,
    "approved": true,
    "is_active": true,
    "published_at": "2026-10-27T07:00:00Z",
    "created_at": "2026-10-26T07:00:00Z"
  }],
  "pagination": { "page": 1, "limit": 20, "total": 1 }
}

Загрузка всех страниц

Увеличивайте page, пока page × limit не достигнет pagination.total. Сохраняйте id вакансии как ключ связи в вашей системе; название может измениться.

Проверяйте archived, approved и is_active отдельно. Название или наличие записи в ответе само по себе не подтверждает, что вакансия опубликована.