Что это
Workable API - интерфейс интеграции с системой подбора персонала и HR. Он дает доступ к разрешенным ресурсам, например вакансиям, кандидатам и событиям. Для внутреннего подключения используют токен с подходящими scopes и адрес аккаунта.
У Workable есть отдельные ИИ-возможности и Workable Agent. Но обычное чтение /jobs не запускает оценку кандидатов и не дает все функции агента бесплатно. Такие продукты, данные и расходы нужно рассматривать отдельно.
Начните с списка опубликованных вакансий без выгрузки резюме. Это проверяет доступ и связь с нужной организацией. Решения о найме, отказе и оценке людей не следует поручать модели только потому, что API позволяет изменить данные.
Ключевые параметры
- Категория: Операционные задачи
- Сложность: Для разработчика
- Запуск: Около 30 минут
- Open-source: Нет
- Данные: Не известно
- Чувствительные данные: Только с настройками
Сильные стороны
- Scope r_jobs позволяет ограничить первый сценарий чтением вакансий.
- Ответы API содержат структурированные поля и ссылки вакансий.
- paging.next позволяет продолжить выборку без ручного разбора cursor.
- Заголовки лимитов помогают регулировать частоту запросов.
Ограничения
- Нужны аккаунт организации, разрешение и подходящие scopes.
- Workable API не поддерживает прямой CORS-доступ из браузера.
- Полный список требует обработки пагинации и лимитов.
- Персональные данные кандидатов и отдельные ИИ-функции требуют самостоятельных правил доступа и условий.
Как использовать
1. Подготовка. Получите согласие администратора и выберите чтение опубликованных вакансий. Запишите subdomain своей организации и одну ожидаемую вакансию; кандидаты и сотрудники для теста не нужны.
2. Настройка. В Integrations создайте токен с r_jobs и сохраните его в защищенных серверных настройках. Не добавляйте r_candidates, r_employees и права записи без отдельной задачи. Токен показывается при создании один раз.
3. Первый результат. Выполните GET https://{subdomain}.workable.com/spi/v3/jobs?state=published&limit=2 с Authorization: Bearer <токен>. Прочитайте массив jobs: id, title, shortcode, state и url. Составьте короткий список без персональных данных.
4. Проверка. Сверьте вакансии в Workable. Если есть paging.next, используйте его для следующей страницы; первая пара не равна всему списку. Разделите пустой результат и ошибки 401/404, а 429 обрабатывайте с учетом X-Rate-Limit-Reset. API id не следует считать тем же ID, который виден в интерфейсе; сверяйте также shortcode и название.
Примеры сценариев
- Собрать короткий список опубликованных вакансий.
- Проверить полноту отчета по paging.next.
- Сверить доступ интеграции без чтения резюме.
Доступ и оплата
- Модель оплаты: Платно
- Бесплатный тариф: Нет
- Пробный доступ: Да
- Работа в РФ: Нужно проверять
- VPN: Не известно
- Русский интерфейс: Не известно
- Русский язык: Не известно
Workable - платная корпоративная система с trial. Пробный период не равен постоянному бесплатному плану и не включает Workable Agent по проверенным условиям. Конкретный API-доступ подтвердите в аккаунте. Возможность подключения и оплаты из России здесь не проверена.
Когда не подходит
- Автоматически отказать кандидату по выводу модели
- Выгрузить все резюме ради проверки подключения
- Считать обычный API подпиской на Workable Agent
Альтернативы
Greenhouse API и Lever API интегрируют соответствующие ATS. Google Sheets API подходит для простой таблицы вакансий, но не заменяет ATS и ее права. Для собственной базы Workable нужен именно доступ Workable.
