Zum Inhalt

Umgang mit API-Ratenbegrenzungen#

API-Ratenbegrenzungen sind Beschränkungen der Anfragehäufigkeit. Beispielsweise kann eine API die Anzahl der Anfragen begrenzen, die Sie pro Minute oder pro Tag stellen können.

APIs können auch begrenzen, wie viele Daten Sie in einer Anfrage senden können oder wie viele Daten die API in einer einzelnen Antwort sendet.

Erkennen von Problemen mit Ratenbegrenzungen#

Wenn ein Localmind Automate-Knoten an eine Ratenbegrenzung stößt, tritt ein Fehler auf. Localmind Automate zeigt die Fehlermeldung im Ausgabefeld des Knotens an. Dies beinhaltet die Fehlermeldung des Dienstes.

Wenn Localmind Automate den Fehler 429 (zu viele Anfragen) vom Dienst empfangen hat, lautet die Fehlermeldung Der Dienst empfängt zu viele Anfragen von Ihnen.

Um die Ratenbegrenzungen für den von Ihnen verwendeten Dienst zu überprüfen, lesen Sie die API-Dokumentation für den Dienst.

Behandeln von Ratenbegrenzungen für Integrationen#

Es gibt zwei Möglichkeiten, Ratenbegrenzungen in Localmind Automate-Integrationen zu behandeln: Verwenden der Einstellung "Bei Fehler erneut versuchen" oder Verwenden einer Kombination aus den Knoten Elemente durchlaufen und Warten:

  • Bei Fehler erneut versuchen fügt eine Pause zwischen API-Anforderungsversuchen hinzu.
  • Mit Elemente durchlaufen und Warten können Sie Ihre Anforderungsdaten in kleinere Blöcke aufteilen und zwischen den Anforderungen pausieren.

Aktivieren von "Bei Fehler erneut versuchen"#

Wenn Sie "Bei Fehler erneut versuchen" aktivieren, versucht der Knoten die Anfrage automatisch erneut, wenn sie beim ersten Mal fehlschlägt.

  1. Öffnen Sie den Knoten.
  2. Wählen Sie Einstellungen.
  3. Aktivieren Sie den Schalter Bei Fehler erneut versuchen.
  4. Konfigurieren Sie die Wiederholungseinstellungen: Wenn Sie dies verwenden, um Ratenbegrenzungen zu umgehen, legen Sie Wartezeit zwischen Versuchen (ms) auf mehr als die Ratenbegrenzung fest. Wenn die von Ihnen verwendete API beispielsweise eine Anfrage pro Sekunde zulässt, setzen Sie Wartezeit zwischen Versuchen (ms) auf 1000, um eine Wartezeit von 1 Sekunde zu ermöglichen.

Verwenden von Elemente durchlaufen und Warten#

Verwenden Sie den Knoten Elemente durchlaufen, um die Eingabeelemente zu batchen, und den Knoten Warten, um eine Pause zwischen den einzelnen Anforderungen einzuführen.

  1. Fügen Sie den Knoten Elemente durchlaufen vor dem Knoten hinzu, der die API aufruft. Informationen zum Konfigurieren des Knotens finden Sie unter Elemente durchlaufen.
  2. Fügen Sie den Knoten Warten nach dem Knoten hinzu, der die API aufruft, und verbinden Sie ihn zurück mit dem Knoten Elemente durchlaufen. Informationen zum Konfigurieren des Knotens finden Sie unter Warten.

Behandeln von Ratenbegrenzungen im HTTP-Anfrage-Knoten#

Der HTTP-Anfrage-Knoten verfügt über integrierte Einstellungen zum Behandeln von Ratenbegrenzungen und großen Datenmengen.

Stapelverarbeitung von Anfragen#

Verwenden Sie die Stapelverarbeitungsoption, um mehr als eine Anfrage zu senden, die Anforderungsgröße zu reduzieren und eine Pause zwischen den Anfragen einzuführen. Dies entspricht der Verwendung von Elemente durchlaufen und Warten.

  1. Wählen Sie im HTTP-Anfrage-Knoten Option hinzufügen > Stapelverarbeitung.
  2. Legen Sie Elemente pro Stapel fest: Dies ist die Anzahl der Eingabeelemente, die in jede Anfrage aufgenommen werden sollen.
  3. Legen Sie Stapelintervall (ms) fest, um eine Verzögerung zwischen den Anfragen einzuführen. Wenn die von Ihnen verwendete API beispielsweise eine Anfrage pro Sekunde zulässt, setzen Sie Wartezeit zwischen Versuchen (ms) auf 1000, um eine Wartezeit von 1 Sekunde zu ermöglichen.

Paginieren von Ergebnissen#

APIs paginieren ihre Ergebnisse, wenn sie mehr Daten senden müssen, als sie in einer einzelnen Antwort verarbeiten können. Weitere Informationen zur Paginierung im HTTP-Anfrage-Knoten finden Sie unter HTTP-Anfrage-Knoten | Paginierung.