Перейти до основного вмісту
API GetQR перебуває в бета-версії та доступний для окремих робочих просторів. До загального релізу деталі можуть змінитися.
API GetQR обмежує кількість запитів, які може надіслати кожен 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-коди