Перейти к основному содержанию
GetQR API находится в бета-версии и доступен для отдельных рабочих пространств. До общего релиза детали могут измениться.
GetQR API ограничивает число запросов с каждого API-ключа, чтобы одна интеграция не замедляла API для всех.

Лимиты

Лимит считается в скользящем окне длиной в одну минуту и действует на все эндпоинты вместе. Проверке состояния ключ не нужен, и она не учитывается.

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

Ответы на запросы с валидным API-ключом, включая ответы с ошибками, содержат эти заголовки:

Превышение лимита

При превышении лимита API отвечает 429 с кодом rate_limit_exceeded и теми же заголовками:
Дождитесь времени сброса, прежде чем отправлять новые запросы. Добавьте случайную задержку (jitter), чтобы несколько воркеров не повторяли запросы одновременно, и используйте экспоненциальную задержку при ошибках 5xx:
Повторяйте POST /api/v1/qrs только с заголовком Idempotency-Key. Тогда повтор никогда не создаст второй QR-код. См. Идемпотентность.

Как не превышать лимит

  • Следите за X-RateLimit-Remaining и снижайте темп, пока значение не дошло до 0.
  • Используйте массовое создание QR-кодов вместо отдельного запроса на каждый QR-код.
  • Получайте до 100 результатов на страницу с pageSize=100. См. Пагинация.
  • Кэшируйте изображения QR-кодов: скачивания возвращают ETag, поэтому можно отправить If-None-Match и получить 304 Not Modified, если ничего не изменилось.

Что дальше

Ошибки

QR-коды