Разделы

API v1: интеграция с OTKLIQ

Ключи выпускаются в кабинете — раздел API. Здесь только описание методов.

База: /api/v1. Авторизация: Authorization: Bearer hrt_…. Ограничение: 120 запросов в минуту на ключ, остаток в заголовке X-RateLimit-Remaining.

Методы

GET /testsсписок тестов с названиями и описаниями
GET /candidatesсписок кандидатов кабинета
POST /candidatesсоздать кандидата и получить постоянную ссылку
GET /candidates/{id}данные кандидата и статусы прохождения
POST /candidates/{id}/recommendзадать рекомендуемые тесты
GET /candidates/{id}/resultsрезультаты и расширенные отчёты
GET /candidates/{id}/scorecardкарта критериев, что скрыто в тени и подпись человека
POST /candidates/{id}/inviteотправить кандидату ссылку на его почту
GET /hhподключённые кабинеты, вакансии и бонусы
GET /tgсостояние телеграм-бота уведомлений
POST /tg/linkпроверить, кто уже написал боту
POST /tg/inviteдобавить получателя по нику @nick
POST /tg/codeсменить персональную ссылку-приглашение
POST /tg/chats/{id}включить/выключить получателя
DELETE /tg/chats/{id}убрать получателя
POST /tg/testотправить проверочное сообщение
POST /hh/vacancies/{id}/finalсохранить итоговый вариант вакансии, собранный человеком
POST /hh/vacancies/{id}/applyзаписать итоговый вариант в саму вакансию на hh.ru
POST /hh/syncобновить список вакансий из кабинета
GET /hh/vacancies/{id}отклики вакансии с оценкой анкеты и диалога
POST /hh/vacancies/{id}/pullзагрузить отклики вакансии из HeadHunter
GET /hh/responses/{id}карточка отклика: оценка, переписка, черновики
GET /hh/responses/{id}/stagesэтапы воронки этой вакансии и текущий
GET /hh/vacancies/{id}/stagesэтапы воронки вакансии для настроек
GET /hh/vacancies/{id}/testsметодики: каталог и что назначено на этапах
POST /hh/vacancies/{id}/testsназначить методики на этапы воронки
POST /hh/vacancies/{id}/test-adviceчто ИИ советует дать на этой вакансии и почему
POST /hh/vacancies/{id}/autofillзаполнить настройки вакансии через ИИ, не сохраняя
POST /hh/vacancies/{id}/improveпричесать текст работодателя, не меняя смысла
POST /hh/vacancies/{id}/rewriteпредложить улучшенную вакансию: было/стало и правки с причинами
GET /hh/vacancies/{id}/rewrite/readyготово ли предложение и сколько обычно считается
POST /hh/outbox/{id}/sendотправить черновик кандидату
POST /candidates/{id}/decisionзафиксировать решение человека: на интервью, в резерв или отказ
GET /vacanciesсписок вакансий (подтягиваются из HeadHunter, вручную не создаются)
POST /vacancies/{id}/candidatesпривязать кандидата к вакансии
GET /compareсводный рейтинг кандидатов
GET /subscriptionподписка и остаток лимита
GET /payments/{id}статус платежа

Подключение кабинета HeadHunter и автоматическая работа с откликами сейчас в разработке; их методы в публичное описание не вынесены.

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"}'

Коды методик, доступных вашему кабинету, отдаёт GET /tests — в описании они не перечисляются намеренно: по коду методику находят и готовятся к ней заранее.