Обновлено: 21 октября 2026
Условия API
Правила для ключей, созданных в HR Suite, и для людей, скриптов и ИИ-агентов, которые ими пользуются.
Коротко
- Ключ действует от имени вашей компании в пределах своих прав. Всё, что им сделано, сделано вами.
- ИИ-агент с правом записи может публиковать вакансии, двигать кандидатов, менять записи и утверждать расчёты. Давайте права, которые имеете в виду, ставьте срок и читайте лог.
- Шестьдесят вызовов в минуту, двадцать записей в минуту на ключ. Каждый вызов логируется девяносто дней.
- О ломающих изменениях сообщаем за тридцать дней; действующие эндпоинты на hr.findjobs.ge/hr/api/v1/openapi.json.
1. Ключи
Только владелец аккаунта создаёт и отзывает ключи, за свежим вторым замком. Ключ показывается один раз и хранится хешированным; мы не можем показать его снова. Ключ несёт выбранные вами права и необязательный срок. Демо-ключ действует только на демо-компанию.
Ключ — секрет. Не кладите его в браузер, публичный репозиторий или общий документ. Если ключ утёк, немедленно отзовите его в Настройки › API-ключи; сделанное им до отзыва остаётся в силе.
2. Действие от вашего имени
Каждый вызов ключом — действие вашей компании: публикация или закрытие вакансий, ответы кандидатам, перемещение между этапами, оценка, добавление или изменение записей, решения об отпусках, утверждение расчётов, создание файлов. Это одинаково относится к человеку, скрипту и ИИ-агенту. Мы не можем отличить ошибочное указание от намеренного.
ИИ-агент следует указаниям, которые ему дали, и тексту, который он читает, включая текст от кандидатов и из документов. Давайте агенту самые узкие права, которые выполняют задачу, предпочитайте права на чтение, ставьте срок и просматривайте лог вызовов. Шаги, которые система помечает как требующие человека (договор, сообщение кандидатам, утверждение расчёта), просят его и при вызове ключом, если вы это не отключили.
3. Лимиты и логирование
Шестьдесят вызовов и двадцать записей в минуту на ключ; сверх лимита API отвечает 429 со временем повтора. Каждый вызов логируется с эндпоинтом, статусом и временем девяносто дней; владелец читает лог в Настройки › API-ключи. Мы можем снизить лимиты ключу, который нагружает сервис, и сообщить вам.
4. Допустимое использование
Используйте API только для своей компании. Не используйте его для скрейпинга findjobs.ge, чтения чужих данных, отправки сообщений, нарушающих условия findjobs.ge (включая что-либо, указывающее на Telegram или Signal), публикации дискриминационных вакансий или перепродажи доступа. Мы можем приостановить ключ, нарушающий эти правила.
5. Изменения и доступность
Действующие эндпоинты описаны на hr.findjobs.ge/hr/api/v1/openapi.json и hr.findjobs.ge/hr/docs/api. Мы добавляем эндпоинты без уведомления. Изменение, ломающее существующий эндпоинт, объявляется по почте за тридцать дней; старое поведение остаётся доступным на этот период. API предоставляется «как доступен», с той же заботой, что и система.
6. Ответственность
Применяется раздел 12 условий обслуживания HR Suite. Мы не отвечаем за то, что человек, скрипт или агент делает созданным вами ключом. Применяется право Грузии; грузинский текст имеет приоритет.
Грузинский текст имеет приоритет; остальные языки — переводы.