Salt la conținutul principal
API-ul GetQR este în versiune beta și este disponibil pentru anumite spații de lucru. Detaliile se pot schimba înainte de lansarea generală.
API-ul GetQR limitează numărul de cereri pe care le poate trimite fiecare cheie API, astfel încât o singură integrare să nu încetinească API-ul pentru toți ceilalți.

Limite

Limita se calculează pe o fereastră glisantă de un minut și se aplică tuturor endpointurilor împreună. Verificarea stării nu necesită cheie și nu se contorizează.

Anteturi pentru limitele de cereri

Răspunsurile la cererile cu o cheie API validă includ aceste anteturi, inclusiv răspunsurile de eroare:

Când depășiți limita

Peste limită, API-ul răspunde cu 429, codul rate_limit_exceeded și aceleași anteturi:
Așteptați până la ora resetării înainte de a trimite alte cereri. Adăugați o variație aleatorie (jitter), astfel încât mai mulți workeri să nu reîncerce în același moment, și folosiți backoff exponențial pentru erorile 5xx:
Reîncercați POST /api/v1/qrs doar cu un antet Idempotency-Key. Astfel, o reîncercare nu creează niciodată un al doilea cod QR. Consultați Idempotență.

Rămâneți sub limită

  • Urmăriți X-RateLimit-Remaining și încetiniți înainte să ajungă la 0.
  • Folosiți crearea QR în masă în locul unei cereri pentru fiecare cod QR.
  • Obțineți până la 100 de rezultate pe pagină cu pageSize=100. Consultați Paginare.
  • Stocați în cache imaginile QR: descărcările returnează un ETag, așa că puteți trimite If-None-Match și primiți 304 Not Modified când nu s-a schimbat nimic.

Ce urmează

Erori

Coduri QR