Przejdź do głównej treści
API GetQR jest w wersji beta i jest dostępne dla wybranych obszarów roboczych. Szczegóły mogą się zmienić przed ogólną premierą.
API GetQR ogranicza liczbę żądań, które może wysłać każdy klucz API, aby jedna integracja nie spowalniała API dla wszystkich.

Limity

Limit jest liczony w przesuwnym oknie jednominutowym i obejmuje wszystkie endpointy łącznie. Sprawdzenie stanu nie wymaga klucza i nie jest wliczane.

Nagłówki limitów

Odpowiedzi na żądania z prawidłowym kluczem API zawierają te nagłówki, również odpowiedzi z błędem:

Po przekroczeniu limitu

Po przekroczeniu limitu API odpowiada 429 z kodem rate_limit_exceeded i tymi samymi nagłówkami:
Przed wysłaniem kolejnych żądań poczekaj do momentu resetu. Dodaj losowe opóźnienie (jitter), aby kilka procesów nie ponawiało żądań w tej samej chwili, a przy błędach 5xx wydłużaj odstępy wykładniczo:
Ponawiaj POST /api/v1/qrs tylko z nagłówkiem Idempotency-Key. Wtedy ponowienie nigdy nie utworzy drugiego kodu QR. Zobacz Idempotentność.

Jak nie przekraczać limitu

  • Obserwuj X-RateLimit-Remaining i zwolnij, zanim wartość spadnie do 0.
  • Używaj masowego tworzenia kodów QR zamiast jednego żądania na każdy kod QR.
  • Pobieraj do 100 wyników na stronę z pageSize=100. Zobacz Paginacja.
  • Buforuj obrazy kodów QR: pobrania zwracają ETag, więc możesz wysłać If-None-Match i otrzymać 304 Not Modified, gdy nic się nie zmieniło.

Co dalej

Błędy

Kody QR