Перейти к материалам

Быстрый старт

Что можно сделать через API

Open API uhead позволяет получать вакансии компании, отклики кандидатов, не отнесённые к неподходящим по портрету вакансии, и вести переписку с кандидатами. Запросы отправляются на openapi.uhead.ru с внешним токеном компании.

Для готовой CRM начните с инструкции по её подключению: uhead сможет передавать отклики в целевую систему без разработки собственного клиента.

Получите токен

  1. Войдите в кабинет нужной компании и откройте «Настройки → Доступ к API».
  2. Создайте токен и сохраните его в защищённом хранилище на сервере вашей интеграции.
  3. Передавайте токен в заголовке Authorization: Bearer YOUR_TOKEN. У токена есть доступ только к своей компании.

Выполните первый запрос

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

Окружения

Для тестирования используйте development и токен компании этого окружения. Токены и данные prod и dev используйте раздельно.

Все примеры используют Open API production. Для dev замените /prod/ на /dev/ в адресе запроса. Путь метода добавляется к базовому адресу; префикса /api здесь нет.

Справочник Open API uhead

ОкружениеБазовый адрес с версией API
Productionhttps://openapi.uhead.ru/prod/external/v1
Developmenthttps://openapi.uhead.ru/dev/external/v1

Методы и параметры описаны по публичной спецификации Open API uhead. Открыть справочник Open API