API-Ratenbegrenzungen und Wiederholungen

API-Ratenbegrenzungen und Wiederholungen sind Teil des Vertrags zwischen einem Client und einer API. Ein Client sollte zwischen Erfolg, Validierungsfehlern, fehlgeschlagener Authentifizierung, Ratenbegrenzungen und vorübergehenden Serverfehlern unterscheiden. Ob JSON oder XML, ändert nichts an der HTTP-Semantik, und IPv4/IPv6-Werte müssen vollständig erhalten bleiben, ohne von der Länge einer IPv4-Adresse auszugehen.

So verarbeiten Sie die Antwort

Prüfen Sie Content-Type, Statuscode, dokumentierte Felder und Kontingent. Behandeln Sie HTTP 429 gesondert, beachten Sie Retry-After, sofern angegeben, und verwenden Sie einen begrenzten exponentiellen Backoff mit Jitter. Klären Sie vor jeder Wiederholung, ob der Vorgang idempotent ist. Protokollieren Sie Anfrage-IDs, Status und Latenz, aber niemals API-Geheimnisse.

Richtig auf HTTP 429 reagieren

Wenn die API 429 zurückgibt, lesen Sie Retry-After aus, sofern vorhanden, statt blind ein festes Intervall zu warten. Begrenzen Sie die Anzahl der Wiederholungen, ergänzen Sie den exponentiellen Backoff um Jitter und vermeiden Sie die automatische Wiederholung von Vorgängen, die doppelte Nebenwirkungen erzeugen können. Eine echte Anfrage und den aktuellen API-Vertrag finden Sie bei der 2IP API.