Spring til hovedindhold
GetQR API’et er i beta og er tilgængeligt for udvalgte arbejdsområder. Detaljer kan ændre sig før den generelle udgivelse.
GetQR API’et begrænser, hvor mange forespørgsler hver API-nøgle kan sende, så én integration ikke kan gøre API’et langsomt for alle andre.

Grænser

Grænsen tælles over et glidende vindue på ét minut og gælder for alle endepunkter samlet. Statustjekket kræver ingen nøgle og tæller ikke med.

Headere for hastighedsgrænser

Svar på forespørgsler med en gyldig API-nøgle har disse headere, også fejlsvar:

Når du overskrider grænsen

Over grænsen svarer API’et 429 med koden rate_limit_exceeded og de samme headere:
Vent til nulstillingstidspunktet, før du sender flere forespørgsler. Tilføj jitter, så flere workers ikke prøver igen på samme tid, og brug eksponentiel backoff ved 5xx-fejl:
Prøv kun POST /api/v1/qrs igen med en Idempotency-Key-header. Så opretter et nyt forsøg aldrig en QR-kode mere. Se Idempotens.

Hold dig under grænsen

  • Hold øje med X-RateLimit-Remaining, og sænk tempoet, før den når 0.
  • Brug bulk-oprettelse af QR-koder i stedet for én forespørgsel pr. QR-kode.
  • Hent op til 100 resultater pr. side med pageSize=100. Se Paginering.
  • Cache QR-billeder: Downloads returnerer en ETag, så du kan sende If-None-Match og få 304 Not Modified, når intet er ændret.

Næste skridt

Fejl

QR-koder