Быстрый старт
Что можно сделать через API
Open API uhead позволяет получать вакансии компании, отклики кандидатов, не отнесённые к неподходящим по портрету вакансии, и вести переписку с кандидатами. Запросы отправляются на openapi.uhead.ru с внешним токеном компании.
Для готовой CRM начните с инструкции по её подключению: uhead сможет передавать отклики в целевую систему без разработки собственного клиента.
Получите токен
- Войдите в кабинет нужной компании и откройте «Настройки → Доступ к API».
- Создайте токен и сохраните его в защищённом хранилище на сервере вашей интеграции.
- Передавайте токен в заголовке Authorization: Bearer YOUR_TOKEN. У токена есть доступ только к своей компании.
Выполните первый запрос
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 здесь нет.
| Окружение | Базовый адрес с версией API |
|---|---|
| Production | https://openapi.uhead.ru/prod/external/v1 |
| Development | https://openapi.uhead.ru/dev/external/v1 |
Методы и параметры описаны по публичной спецификации Open API uhead. Открыть справочник Open API