API v1
Ключи выпускаются в кабинете — раздел API. Здесь только описание методов.
База: /api/v1. Авторизация: Authorization: Bearer hrt_….
Ограничение: 120 запросов в минуту на ключ, остаток в заголовке X-RateLimit-Remaining.
Методы
| GET | /tests | список тестов с названиями и описаниями |
| GET | /candidates | список кандидатов кабинета |
| POST | /candidates | создать кандидата и получить постоянную ссылку |
| POST | /candidates/import | импорт кандидата по ссылке (нужна подписка) |
| GET | /candidates/{id} | данные кандидата и статусы прохождения |
| POST | /candidates/{id}/recommend | задать рекомендуемые тесты |
| GET | /candidates/{id}/results | результаты и расширенные отчёты |
| GET | /candidates/{id}/scorecard | карта критериев, что скрыто в тени и подпись человека |
| POST | /candidates/{id}/invite | отправить кандидату ссылку на его почту |
| POST | /candidates/{id}/decision | зафиксировать решение человека: на интервью, в резерв или отказ |
| GET | /vacancies | список вакансий |
| POST | /vacancies | создать вакансию |
| POST | /vacancies/{id}/candidates | привязать кандидата к вакансии |
| GET | /compare | сводный рейтинг кандидатов |
| GET | /subscription | подписка и остаток лимита |
| GET | /payments/{id} | статус платежа |
Webhooks
Событие attempt.finished
отправляется POST-запросом на ваш HTTPS-адрес. Подпись тела — HMAC-SHA256 в заголовке
X-HRTest-Signature, секрет выдаётся при создании.
Пример
curl -X POST https://otkliq.ru/api/v1/candidates \
-H "Authorization: Bearer hrt_ваш_ключ" \
-H "Content-Type: application/json" \
-d '{"last_name":"Иванов","first_name":"Пётр","email":"p@example.com","tests":["Tools","Logis"]}'