Интеграция

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

Endpoints оператора ограничены на партнёра в минуту, чтобы одна интеграция не мешала остальным. Квоты применяются к аутентифицированным вызовам (partner и api_key известного проекта) в трёх независимых классах:

Квота — «ведро токенов»: полную минуту вызовов можно отправить пачкой, токены возвращаются непрерывно. Текущие значения окружения — в rateLimits метода GET /capabilities; более высокие значения можно согласовать с менеджером аккаунта.

При превышении ответ HTTP 429, ничего не выполняется:

HTTP/1.1 429 Too Many Requests
Retry-After: 7
X-RateLimit-Limit: 600/min
content-type: application/json

{"status":"error","message":"RATE_LIMITED"}

Успешные ответы несут X-RateLimit-Limit и X-RateLimit-Remaining для класса.

Рекомендации#

• При 429 подождите Retry-After секунд и повторите с тем же Idempotency-Key.
• Не опрашивайте отчёты: листайте report_rounds через cursor, report_ggr и report_reconciliation вызывайте раз в период.
• Публичные методы чтения (/games/catalog, /games/health, /capabilities) можно кэшировать на несколько минут — не вызывайте их на каждого игрока.
• Callbacks платформы к вам в эти квоты не входят; пусть ваш кошелёк отвечает в пределах 2 секунд (Callbacks кошелька).