Zum Hauptinhalt springen
Die GetQR API befindet sich in der Beta-Phase und steht ausgewählten Workspaces zur Verfügung. Details können sich bis zur allgemeinen Veröffentlichung noch ändern.
Die GetQR API begrenzt, wie viele Anfragen jeder API-Schlüssel senden kann, damit eine einzelne Integration die API nicht für alle verlangsamt.

Limits

Das Limit wird über ein gleitendes Zeitfenster von einer Minute gezählt und gilt für alle Endpunkte zusammen. Die Statusprüfung braucht keinen Schlüssel und wird nicht mitgezählt.

Header zur Ratenbegrenzung

Antworten auf Anfragen mit gültigem API-Schlüssel enthalten diese Header, auch Fehlerantworten:

Wenn Sie das Limit überschreiten

Oberhalb des Limits antwortet die API mit 429, dem Code rate_limit_exceeded und denselben Headern:
Warten Sie bis zum Reset-Zeitpunkt, bevor Sie weitere Anfragen senden. Fügen Sie Jitter hinzu, damit mehrere Worker nicht im selben Moment erneut anfragen, und verwenden Sie bei 5xx-Fehlern exponentiellen Backoff:
Wiederholen Sie POST /api/v1/qrs nur mit einem Idempotency-Key-Header. Dann erstellt eine Wiederholung nie einen zweiten QR-Code. Siehe Idempotenz.

Unter dem Limit bleiben

  • Beobachten Sie X-RateLimit-Remaining und drosseln Sie das Tempo, bevor der Wert 0 erreicht.
  • Verwenden Sie die Massenerstellung statt einer Anfrage pro QR-Code.
  • Rufen Sie mit pageSize=100 bis zu 100 Ergebnisse pro Seite ab. Siehe Paginierung.
  • Speichern Sie QR-Bilder im Cache: Downloads liefern einen ETag, sodass Sie If-None-Match senden können und 304 Not Modified erhalten, wenn sich nichts geändert hat.

Wie geht es weiter?

Fehler

QR-Codes