Anfragelimits (Rate Limits)
Damit der Dienst für alle stabil bleibt, wendet Cord ein Anfragelimit pro IP an.
Das Limit
Es gibt eine globale Untergrenze von etwa 500 Anfragen pro Minute pro IP über alle Routen. Zusätzlich hat jeder API-Schlüssel sein eigenes Limit: 600 Anfragen pro Minute für einen geheimen Schlüssel (sk_) und 120 pro Minute für einen veröffentlichbaren Schlüssel (pk_, stärker eingeschränkt, weil er offen im Browser liegt). Alle sind Limits pro Minute (gleitendes Fenster von 60 Sekunden), nicht pro Sekunde. Für normale B2B-Integrationen (Kataloge synchronisieren, Angebote erstellen, offene Forderungen lesen) bleibt damit reichlich Spielraum.
Unabhängig vom Anfragelimit enthält Ihr Tarif ein monatliches Kontingent an API-Aufrufen; wird es überschritten, antwortet die API ebenfalls mit 429, aber mit code: "api_quota_exceeded" statt eines Geschwindigkeitsproblems – die Lösung ist dann ein höherer Tarif, nicht langsameres Wiederholen.
Umgang mit 429
Wenn Sie das Anfragelimit überschreiten, antwortet Cord mit 429 Too Many Requests und einem Header Retry-After: 60 (Sekunden). Ihre Anwendung sollte dies mit exponentiellem Backoff behandeln:
- Wenn Sie einen 429 erhalten, warten Sie und versuchen Sie es erneut (beachten Sie
Retry-After, falls vorhanden). - Schlägt es erneut fehl, verdoppeln Sie die Wartezeit: 1 s, 2 s, 4 s, 8 s …
- Legen Sie eine Obergrenze für Wiederholungen fest, damit Sie nicht in einer Schleife hängen bleiben.
Bewährte Vorgehensweisen: Bündeln Sie Lesevorgänge mit Paginierung (limit/offset) statt vieler kleiner Aufrufe, und vermeiden Sie aggressives Polling – um über Änderungen informiert zu werden, verwenden Sie Webhooks, statt in einer Schleife abzufragen.