API HHBro для разработчиков
Публичный REST API для интеграции с сервисами HHBro: вакансии, резюме, AI-анализ, кредитный баланс.
Быстрый старт
- Базовый URL:
https://hhbro.ru/api/v2
- Аутентификация: OAuth 2.0 (Laravel Passport), Bearer Token в заголовке
Authorization
- Формат: JSON, кодировка UTF-8
- OpenAPI-спецификация: /openapi-v2.json
- Swagger UI: /api/documentation/v2
Категории эндпоинтов
- Аутентификация и пользователь: регистрация, OAuth-callback, профиль, баланс кредитов
- Резюме: CRUD резюме, AI-улучшение, AI-распознавание из текста
- Вакансии: мультипоиск (HH/SJ/Trudvsem/Zarplata), детальный анализ, batch-анализ
- SmartSearch (автопоиск): создание/управление, статистика, run-history
- Сопроводительные письма: генерация, стили, разблокировка
- Аналитика вакансии: переговоры о зарплате, подготовка к собеседованию, red flags
- Платежи: покупка кредитов, история транзакций, реферальная программа
- Новости: публичный список и карточки статей
Лимиты и квоты
- Rate limit для пользователей: согласно настройкам Apiato (см.
config/apiato.php)
- AI-операции списывают кредиты с баланса пользователя
- Лимиты SmartSearch: см. документацию автопоиска