Hoppa till huvudinnehåll
GetQR:s API är i beta och finns för utvalda arbetsytor. Detaljer kan ändras före den allmänna lanseringen.
GetQR:s API begränsar hur många begäranden varje API-nyckel kan skicka, så att en enskild integration inte gör API:et långsammare för alla andra.

Gränser

Gränsen räknas över ett glidande fönster på en minut och gäller alla slutpunkter tillsammans. Statuskontrollen behöver ingen nyckel och räknas inte.

Huvuden för hastighetsbegränsning

Svar på begäranden med en giltig API-nyckel innehåller dessa huvuden, även felsvar:

När du överskrider gränsen

Över gränsen svarar API:et 429 med koden rate_limit_exceeded och samma huvuden:
Vänta tills fönstret nollställs innan du skickar fler begäranden. Lägg till slumpmässig fördröjning (jitter) så att flera arbetare inte försöker igen exakt samtidigt, och använd exponentiell backoff vid 5xx-fel:
Försök bara igen med POST /api/v1/qrs om du skickar ett Idempotency-Key-huvud. Då skapar ett nytt försök aldrig en andra QR-kod. Se Idempotens.

Håll dig under gränsen

  • Bevaka X-RateLimit-Remaining och sakta ned innan värdet når 0.
  • Använd massskapande av QR-koder i stället för en begäran per QR-kod.
  • Hämta upp till 100 resultat per sida med pageSize=100. Se Paginering.
  • Cacha QR-bilder: nedladdningar returnerar en ETag, så du kan skicka If-None-Match och få 304 Not Modified när inget har ändrats.

Nästa steg

Fel

QR-koder