Naar hoofdinhoud gaan
De GetQR API is in bèta en beschikbaar voor geselecteerde workspaces. Details kunnen nog veranderen vóór de algemene release.
De GetQR API beperkt hoeveel verzoeken elke API-sleutel kan versturen, zodat één integratie de API niet voor iedereen kan vertragen.

Limieten

De limiet wordt geteld over een glijdend venster van één minuut en geldt voor alle endpoints samen. De statuscontrole heeft geen sleutel nodig en telt niet mee.

Rate limit-headers

Antwoorden op verzoeken met een geldige API-sleutel bevatten deze headers, ook foutantwoorden:

Als je over de limiet gaat

Boven de limiet antwoordt de API met 429, de code rate_limit_exceeded en dezelfde headers:
Wacht tot het resetmoment voordat je meer verzoeken verstuurt. Voeg jitter toe, zodat meerdere workers niet op hetzelfde moment opnieuw proberen, en gebruik exponentiële backoff bij 5xx-fouten:
Probeer POST /api/v1/qrs alleen opnieuw met een Idempotency-Key-header. Dan maakt een nieuwe poging nooit een tweede QR-code aan. Zie Idempotentie.

Onder de limiet blijven

  • Houd X-RateLimit-Remaining in de gaten en vertraag voordat de waarde 0 bereikt.
  • Gebruik bulkaanmaak van QR-codes in plaats van één verzoek per QR-code.
  • Haal tot 100 resultaten per pagina op met pageSize=100. Zie Paginering.
  • Cache QR-afbeeldingen: downloads geven een ETag terug, dus je kunt If-None-Match meesturen en krijgt 304 Not Modified als er niets is veranderd.

Volgende stappen

Fouten

QR-codes