Что это
Greenhouse API объединяет интерфейсы интеграции с системой подбора персонала. Для внутренних данных вакансий, кандидатов и процессов используется Harvest. Публичный Job Board API решает другую задачу и не дает тот же доступ к внутренним данным.
Для нового запуска используйте Harvest v3. Greenhouse сообщил о прекращении доступности v1/v2 после 31 августа 2026 года; старые примеры с Basic Auth и одним API-ключом не подходят как инструкция для новой интеграции.
Harvest v3 не является ИИ-моделью. Анализ резюме и подготовка заметки выполняются отдельным кодом или моделью. Финальное решение о кандидате должен принимать человек; персональные данные нельзя передавать стороннему сервису без разрешенного основания и правил организации.
Ключевые параметры
- Категория: Операционные задачи
- Сложность: Для разработчика
- Запуск: Проектное внедрение
- Данные: Не известно
- Чувствительные данные: Только с настройками
Сильные стороны
- Предоставляет программный доступ к данным подбора вместо ручных выгрузок.
- OAuth и scopes позволяют выделить учетные данные под конкретную интеграцию.
- Постраничная выдача позволяет получать большие списки контролируемо.
- Заголовки лимитов помогают управлять частотой запросов и повторными попытками.
Ограничения
- Нужны подписка организации и права на создание учетных данных.
- Методы требуют подходящих scopes и прав авторизующего пользователя; одного действующего токена недостаточно.
- Старые v1/v2-примеры нужно переработать для v3, включая авторизацию и пагинацию.
- Данные кандидатов требуют строгого контроля доступа, хранения и отправки внешним обработчикам.
Как использовать
1. Подготовка. Получите разрешение администратора и выберите тест только на чтение вакансий, без выгрузки резюме. Уточните, что вашей организации доступен Harvest v3.
2. Настройка. Для внутренней интеграции создайте Harvest V3 (OAuth) credentials, сохраните Client ID и Client Secret на сервере и задайте минимальные scopes. Для list-методов проверьте требуемые права авторизующего пользователя.
3. Первый результат. Получите access_token через POST https://auth.greenhouse.io/token с grant_type=client_credentials. Затем выполните разрешенный GET /v3/jobs?per_page=2 с Bearer-токеном и получите две записи вакансий.
4. Проверка. Сверьте вакансии в интерфейсе Greenhouse. Следующую страницу берите из Link rel="next" без ручного добавления фильтров к cursor. Проверьте 401/403 и обработку 429 через Retry-After; не включайте операции изменения кандидатов в первый запуск.
Примеры сценариев
- Подготовить внутреннюю сводку по вакансиям.
- Сверить данные вакансии между ATS и отчетом.
- Выявить ошибку доступа интеграции без выгрузки данных кандидатов.
Доступ и оплата
- Модель оплаты: Enterprise
- Работа в РФ: Нужно проверять
- VPN: Не известно
- Русский интерфейс: Не известно
- Русский язык: Не известно
Это API корпоративной системы, а не бесплатная подписка на ИИ. Доступ и стоимость уточняйте в своей организации. Для партнерских интеграций предусмотрен другой OAuth-процесс; не используйте внутренние Client Credentials для произвольных клиентов.
Когда не подходит
- Автоматически отказать кандидату по выводу модели
- Использовать старый v1-пример в новой интеграции
- Передавать резюме в сторонний чат без разрешения
Альтернативы
Lever API и Workable API подходят для соответствующих ATS. Google Sheets API годится для простой внутренней таблицы, но не заменяет полноценную ATS. API другой системы не может прочитать вашу базу Greenhouse.
