Leadde Logo

API-Rate Limits verstehen

Eine prägnante Lektion, die erklärt, was API-Rate Limits sind, warum sie implementiert werden, häufige Fehler bei Wiederholungsversuchen und effektive Muster wie exponentielles Backoff.
LVon Leadde Aktualisiert 22. August 2026

Wie ein Rate Limit Ihre Anfrage steuert

Ein Rate Limit begrenzt die Anzahl der Anfragen, die ein Client innerhalb eines Zeitfensters senden darf, und gibt einen 429-Fehler zurück, sobald diese Grenze überschritten wird. Das Limit verhindert, dass ein einzelner Client Kapazitäten beansprucht, die allen zustehen. Daher ist die korrekte Reaktion, die Geschwindigkeit zu drosseln, anstatt dieselbe Anfrage sofort erneut zu senden.

Sofortige Wiederholungsversuche sind genau das, was die meisten ersten Integrationen tun, und sie verwandeln eine vorübergehende Ablehnung in eine dauerhafte. Der Client stößt an das Limit, versucht es erneut, verlängert das Messfenster und wird am Ende viel länger gedrosselt, als der ursprüngliche Ansturm es erfordert hätte – meist während ein Entwickler die API für unzuverlässig hält. Bewusst ausgenommen ist Ihre eigene Limit-Konfiguration: Schwellenwerte pro Stufe, Burst-Kontingente und Endpunkte mit strengeren Limits gehören in die versionierte Dokumentation und nicht in ein Video, das veraltet.

Die Vorlage verfolgt eine Anfrage über acht Szenen hinweg: eine darüber, warum Limits überhaupt existieren, eine über das Zeitfenster und dessen Zählung, eine darüber, was eine 429-Antwort enthält, zwei über Backoff und warum die Verzögerung zunehmen muss, eine über Jitter und den Thundering Herd, eine über das Lesen der Rate-Limit-Header und eine über Designansätze, damit das Limit selten erreicht wird.

Backoff in unter zwei Minuten erklären

Entwickler-Schulungen konkurrieren mit der Dokumentation, die der Zuschauer bereits geöffnet hat. Alles, was die Referenzseite wiederholt, wird innerhalb von zwanzig Sekunden geschlossen. Das Modul muss daher das Eine vermitteln, was Dokumentationen schlecht kommunizieren: das Fehlerverhalten statt der Parameter.

Den Wiederholungssturm vor der Lösung aufzeigen

Den Wiederholungssturm vor der Lösung aufzeigen

Ein Client, der alle 200 Millisekunden gegen ein bereits überschrittenes Limit wiederholt, ist das ganze Problem, sichtbar in einer Szene. Backoff erscheint dann als offensichtliche Lösung und nicht nur als Empfehlung.

Die Verdopplung klar darstellen

Eine Sekunde, zwei, vier, acht. Die Darstellung der Progression ist schneller als die Definition von exponentiellem Backoff und entspricht dem, was ein Entwickler tatsächlich implementiert.

Jitter hervorheben

Ohne Randomisierung versuchen alle gedrosselten Clients gleichzeitig erneut, und der Wiederherstellungsversuch wird zum nächsten Ausfall. Dies ist der Teil, den die meisten Integrationen übersehen, und der Grund, warum dieses Modul existiert.

Auf die Header statt auf die Zahlen verweisen

Limits ändern sich; die Header, die sie melden, nicht. Dem Client beizubringen, das zu lesen, was ihm mitgeteilt wird, ist besser, als einen Schwellenwert fest zu codieren, der im nächsten Quartal falsch sein wird.

Aus Ihrer bereits veröffentlichten API-Dokumentation schöpfen

Laden Sie die API-Dokumentation, den an Partner gesendeten Integrationsleitfaden oder die Support-Tickets des letzten Onboardings hoch – maximal 200 MB, als PDF, DOC, DOCX, PPTX oder TXT. Die Szenen können bearbeitet werden, das Originaldokument bleibt unberührt.

An Ihre eigene API anpassen

Ihre eigenen Header-Namen auf dem Bildschirm verwenden

Ihre eigenen Header-Namen auf dem Bildschirm verwenden

Die Benennung von Headern unterscheidet sich zwischen Plattformen, und ein Entwickler, dem ein generisches Beispiel gezeigt wird, muss Ihre dennoch nachschlagen. Die Verwendung der echten Namen in der Szene eliminiert diesen Schritt.

Was nach wiederholten Überschreitungen passiert

Was nach wiederholten Überschreitungen passiert

Manche Plattformen drosseln, manche sperren Schlüssel, manche alarmieren einen Menschen. Eine explizite Darstellung der Konsequenzen beeinflusst, wie ernst ein Partner die Anweisungen nimmt.

Untertitel für präzise Begriffe gestalten

Untertitel für präzise Begriffe gestalten

Statuscodes, Header-Namen und Parameterwerte werden leicht missverstanden, wenn sie nur gehört werden, sind aber zuverlässig lesbar. Wählen Sie aus neun Untertitel-Stilen, verwenden Sie denselben Stil in der gesamten Entwickler-Serie und stellen Sie sicher, dass die Code-Begriffe auch in kleinen Größen lesbar bleiben.

API Rate Limits FAQ

Ein Rate Limit steuert die Geschwindigkeit über ein kurzes Zeitfenster, meist Sekunden oder eine Minute, und ist durch Warten behebbar. Ein Kontingent steuert das Gesamtvolumen über einen Abrechnungszeitraum und ist es nicht. Eine Verwechslung führt dazu, dass Clients einen Backoff durchführen, wenn sie eigentlich eine Erhöhung anfordern müssten.

Den 'retry-after'-Wert lesen, falls vorhanden, mindestens so lange warten und dann mit einer Verzögerung erneut versuchen, die bei jedem weiteren Fehler zunimmt. Sofortiges oder in festen kurzen Intervallen wiederholtes Senden verlängert die Drosselung, anstatt sie aufzuheben.

Endpunkt-Namen sind in Ordnung und machen das Modul nützlicher. Schlüssel und Tokens sind es nicht, auch abgelaufene nicht, da ein Schulungsvideo außerhalb des Partners, für den es erstellt wurde, zirkuliert und viel länger existiert als die Anmeldeinformationen.

Weil die fehlgeschlagene Anfrage in den meisten Implementierungen immer noch auf das Zeitfenster angerechnet wird. Jeder Wiederholungsversuch drängt den Client weiter über das Limit hinaus, sodass die Wartezeit, die zum Aufheben der Drosselung erforderlich ist, mit jedem Versuch, das Warten zu vermeiden, wächst.

Beheben Sie es, bevor es in der Produktion zum Problem wird.

Führen Sie Ihre bereits veröffentlichte API-Dokumentation durch, und optimieren Sie dann die Szenen vor der nächsten Partnerintegration.

avatar

Beginnen Sie mit dieser Vorlage. Enden Sie mit einem teilbaren Video.

Fügen Sie Ihre Onboarding-Anleitung oder Hilfecenter-Seiten hinzu und erstellen Sie in wenigen Minuten einen bearbeitbaren Entwurf.