Квоты и ограничения

API FreeMaint устанавливает ежедневную квоту для каждой компании, которая сбрасывается в полночь по всемирному координированному времени. Ограничение зависит от вашего уровня; счетчики и остальные отображаются как заголовки ответов.

Ежедневные ограничения

• Core, Starter — 0 (для API-ключа нужен Business)
• Business — 5 000 вызовов в день (GraphQL и эндпоинт приёма энергоданных используют один счётчик)
• Enterprise — 100 000 вызовов в день
• On-Premise — без ограничений (лимит = null)

Заголовки ответов

• X-RateLimit-Limit — дневной лимит вашего уровня
• X-RateLimit-Remaining — вызовы, оставшиеся сегодня (уменьшается при каждом вызове, учитываемом квотой)
• X-RateLimit-Reset — временная метка Unix полуночи по всемирному координированному времени (следующий сброс)

Что не считается

Бесплатен только /public-api/whoami: он не уменьшает счётчик, поэтому вы можете проверить ключ и его тариф, не расходуя квоту. Всё, что идёт через /api/v1/graphql, учитывается, включая запрос whoami, — как и эндпоинт приёма энергоданных.

Что считается одним вызовом

Счётчик увеличивается на КАЖДУЮ ОПЕРАЦИЮ, а не на HTTP-запрос. Пятьдесят мутаций с псевдонимами в одном запросе всё равно израсходуют 50 единиц. Группировка экономит сетевые обращения, но не квоту. Чтобы регулярная синхронизация оставалась дешёвой, забирайте только изменения через parts(updatedSince: "..."), а не перечитывайте весь каталог.

Когда вы превышаете лимит

После достижения суточного лимита каждый следующий вызов отклоняется с сообщением «Daily API cap reached». На REST-поверхностях (/public-api/ping, эндпоинт приёма энергоданных) это HTTP 403. В GraphQL статус HTTP равен 200, а отказ находится в errors[0].extensions.code = FORBIDDEN, с originalError.statusCode = 403. Счётчик обнуляется в 00:00 UTC. Нет ни мягкого лимита, ни запаса на всплеск, ни поминутного окна — окно равно суткам.