Zum Inhalt springen
RechnungslotseRechnungslotseRechnungslotseRechnungslotse

← Alle Fehlercodes

rate_limitedSchnittstelle

Zu viele Aufrufe in kurzer Zeit

HTTP 429 der Schnittstelle: Die Taktgrenze hat gegriffen – zu viele Aufrufe in kurzer Zeit, oder zu viele Fehlversuche mit ungültigem Schlüssel aus demselben Netz. Der Aufruf ist nicht verloren: Wiederhole ihn mit wachsendem Abstand, das Kontingent bleibt unberührt.

Wortlaut der Meldung

[rate_limited] Du hast in kurzer Zeit sehr viele Rechnungen erzeugt. Bitte warte einen Moment – oder lege ein kostenloses Konto an.

Stand: September 2026 · Geprüft und geschrieben von Pascal Wagner

Alle Endpunkte und Fehlercodes stehen auf der Seite für Entwickler, mit einem Beispielaufruf zum Abschreiben.

Zur Entwicklerseite

Warum das passiert

  • Ein Bestellschub – etwa nach einer Werbeaktion – schickt viele Aufrufe gleichzeitig, statt sie in einer Warteschlange zu takten.
  • Ein Plugin wiederholt Fehler sofort statt mit wachsendem Abstand und vervielfacht so seine eigene Last.
  • 30 Fehlversuche je Stunde mit fehlendem oder ungültigem Schlüssel aus demselben Netz – die Bremse gegen das Durchprobieren von Schlüsseln.

So behebst du es

  1. Wiederhole mit wachsendem Abstand: erst nach einer Minute, dann fünf, dann dreißig. Das Rechnungslotse-Plugin macht genau das von selbst.
  2. Takte Massenläufe: eine Rechnung nach der anderen statt alle auf einmal – als Richtwert verträgt ein Schlüssel etwa zehn Aufrufe je Minute dauerhaft.
  3. Kommt der Code bei jedem Aufruf, prüf zuerst den Schlüssel: Dauerfeuer mit einem ungültigen Schlüssel hält die Sperre am Leben.

Was die Regel nicht prüft

Die Taktgrenze schützt den Dienst, nicht dein Kontingent – kein Aufruf, der hier abgewiesen wird, verbraucht eine Rechnung. Und der zweite Halbsatz der Meldung („lege ein kostenloses Konto an“) zielt auf den Gratis-Assistenten ohne Konto; für einen Aufruf mit Schlüssel gilt der erste: warten und erneut versuchen.

Was der Empfänger sieht

Nichts – es ist keine Rechnung entstanden. Nach der Wiederholung entsteht genau eine.

Tritt oft zusammen auf mit

Quelle: die Schnittstelle des Rechnungslotsen (/api/v1). Diese Seite beschreibt das dokumentierte Verhalten des Dienstes und ist keine Rechts- oder Steuerberatung. Fehlt etwas oder stimmt etwas nicht? Schreib uns.