Přejít na hlavní obsah
GetQR API je v beta verzi a je dostupné pro vybrané pracovní prostory. Do obecného vydání se podrobnosti mohou změnit.
GetQR API omezuje, kolik požadavků může každý API klíč odeslat, aby jedna integrace nezpomalila API pro všechny ostatní.

Limity

Limit se počítá v posuvném jednominutovém okně a platí pro všechny endpointy dohromady. Kontrola stavu klíč nepotřebuje a do limitu se nepočítá.

Hlavičky limitů

Odpovědi na požadavky s platným API klíčem obsahují tyto hlavičky, a to i chybové odpovědi:

Při překročení limitu

Po překročení limitu API odpoví 429 s kódem rate_limit_exceeded a stejnými hlavičkami:
Než pošlete další požadavky, počkejte do času obnovení. Přidejte náhodný rozptyl (jitter), aby se několik workerů nepokoušelo o opakování ve stejný okamžik, a u chyb 5xx prodlužujte odstup exponenciálně:
POST /api/v1/qrs opakujte jen s hlavičkou Idempotency-Key. Opakovaný pokus pak nikdy nevytvoří druhý QR kód. Viz Idempotence.

Jak zůstat pod limitem

  • Sledujte X-RateLimit-Remaining a zpomalte dřív, než klesne na 0.
  • Místo jednoho požadavku na každý QR kód použijte hromadné vytváření QR kódů.
  • Načítejte až 100 výsledků na stránku pomocí pageSize=100. Viz Stránkování.
  • Ukládejte obrázky QR kódů do mezipaměti: stažení vracejí ETag, takže můžete poslat If-None-Match a když se nic nezměnilo, dostanete 304 Not Modified.

Co dál

Chyby

QR kódy