4 статей

Внешний API

Один ключ на компанию со scope, аутентификация Bearer, 100 запросов в минуту и что делать, пока нет вебхуков.

Создание API-ключа

В «API-ключах» создайте ключ и отметьте scope (сотрудники, зарплата, отделы, должности, учёт времени, отчёты; чтение или запись). Ключ виден один раз.

Аутентификация запросов

Передавайте заголовок Authorization: Bearer <key> в каждом вызове. Неверный ключ даёт 401; верный ключ без нужного scope для эндпоинта даёт 403.

Вебхуки и как отслеживать события сегодня

Исходящих вебхуков пока нет. Чтобы реагировать на события, регулярно опрашивайте эндпоинты чтения, не выходя за лимит 100 запросов в минуту.

Лимиты запросов и scope

100 запросов в минуту на ключ, заголовки X-RateLimit-Limit, X-RateLimit-Remaining и X-RateLimit-Reset в каждом ответе; при превышении 429 с Retry-After.

Не нашли нужное?

Связаться с поддержкой