Ratenbegrenzungen & automatische Wiederholungsversuche
Wie 2sync API-Ratenbegrenzungen von Notion, Google und Microsoft behandelt
2sync kommuniziert bei jedem Synchronisierungszyklus mit externen APIs (Notion, Google, Microsoft, Todoist). Diese APIs erzwingen Ratenbegrenzungen, um Überlastung zu verhindern. 2sync behandelt Ratenbegrenzungen automatisch mit Wiederholungsversuchen und Backoff, sodass Ihre Daten zuverlässig ohne manuellen Eingriff synchronisiert werden.
Was sind Ratenbegrenzungen?
Ratenbegrenzungen sind Einschränkungen von API-Anbietern, wie viele Anfragen eine App in einem bestimmten Zeitraum stellen kann. Wenn 2sync eine Ratenbegrenzung erreicht, lehnt die API vorübergehend weitere Anfragen ab, bis das Limit zurückgesetzt wird.
Jeder Anbieter hat unterschiedliche Limits:
| Anbieter | Verhalten |
|---|---|
| Notion | Begrenzt Anfragen pro Integration pro Sekunde |
| Begrenzt Pro-Nutzer-Kontingent über Kalender, Tasks, Contacts und Gmail | |
| Microsoft | Begrenzt pro App und pro Nutzer über Outlook-Dienste |
| Todoist | Begrenzt Pro-Nutzer-Anfragen pro Minute |
Wie behandelt 2sync Ratenbegrenzungen?
2sync verwendet exponentielles Backoff für alle Wiederholungsversuche. Wenn eine Ratenbegrenzung erreicht wird:
- Die Synchronisierung pausiert für die betroffene API
- 2sync wartet ein zunehmend längeres Intervall vor dem erneuten Versuch (1s, 2s, 4s, 8s usw.)
- Wiederholungsversuche werden fortgesetzt, bis die API Anfragen wieder akzeptiert
- Die Synchronisierung wird dort fortgesetzt, wo sie pausiert wurde
Dieser gesamte Prozess ist transparent. Sie müssen nichts klicken oder Ihre Automatisierung neu starten.
Ratenbegrenzungen sind keine Fehler. Sie sind normales API-Verhalten bei Operationen mit hohem Volumen. 2sync ist so konzipiert, dass es automatisch innerhalb dieser Limits arbeitet.
Was löst Ratenbegrenzungen aus?
Ratenbegrenzungen treten wahrscheinlicher auf bei:
- Erster Synchronisierung einer großen Datenbank (Hunderte oder Tausende von Elementen)
- Massenänderungen, die auf viele Elemente gleichzeitig angewendet werden
- Mehreren Automatisierungen, die denselben Anbieter gleichzeitig synchronisieren
- Anderen Apps, die dasselbe API-Kontingent in Ihrem Konto verwenden
Wie hilft die Stapelverarbeitung?
Für große Synchronisierungsoperationen gruppiert 2sync Änderungen in Stapel, anstatt eine Anfrage pro Element zu senden. Dies reduziert die Gesamtzahl der API-Aufrufe und hält Operationen effektiver innerhalb der Ratenbegrenzungen.
Stapelgrößen passen sich dynamisch basierend auf dem Anbieter und dem aktuellen Ratenbegrenzungsstatus an.
Was sollte ich bei Synchronisierungen mit hohem Volumen erwarten?
Während der Ersteinrichtung oder nach einer langen Pause muss 2sync möglicherweise Tausende von Elementen verarbeiten. In diesen Fällen:
- Synchronisierungszeiten können länger als der übliche Zyklus sein
- Der Automatisierungsstatus zeigt Synchronisiert gerade für einen längeren Zeitraum
- Alle Elemente werden letztendlich synchronisiert; kein manueller Eingriff erforderlich
Wenn Sie einen "Ratenbegrenzung"-Fehler bei Ihrer Automatisierung sehen, bedeutet dies, dass der aktuelle Synchronisierungszyklus aufgrund von API-Limits pausiert wurde. Die nächste geplante Synchronisierung wird normal fortfahren. Es gehen keine Daten verloren.
Wie reduziere ich die Auswirkungen von Ratenbegrenzungen?
Zeitfenster eingrenzen: Die Synchronisierung von 6 Monaten an Terminen erfordert weniger API-Aufrufe als 2 Jahre.
Filter verwenden: Schließen Sie Elemente aus, die Sie nicht benötigen. Weniger synchronisierte Elemente bedeuten weniger API-Anfragen pro Zyklus.
Automatisierungen staffeln: Wenn Sie mehrere Automatisierungen für denselben Anbieter betreiben, erwägen Sie leicht unterschiedliche Synchronisierungszeiten, um die Last zu verteilen.
Massenänderungen nicht direkt vor einer Synchronisierung vornehmen: Wenn Sie Hunderte von Elementen ändern, lassen Sie einen Synchronisierungszyklus abschließen, bevor Sie weitere Änderungen vornehmen.
Bevor Sie eine große Synchronisierung zum ersten Mal aktivieren, führen Sie einen Testlauf durch, um die Anzahl der Änderungen abzuschätzen. Dies hilft Ihnen einzuschätzen, wie lange die erste Synchronisierung dauern wird und ob Ratenbegrenzungen ein Faktor sein werden. Siehe Erweiterte Synchronisierungseinstellungen für Details.
Verwandte Artikel
- Fehlercodes zur Behebung von Ratenbegrenzungen und anderen Fehlerstatus
- Erweiterte Synchronisierungseinstellungen zur Steuerung von Stapelverhalten und Synchronisierungstiming
- Synchronisierungsprobleme zur Fehlerbehebung langsamer oder blockierter Synchronisierungen
- Tarife und Preise für Unterschiede in der Synchronisierungsfrequenz nach Tarif
FAQ
Muss ich etwas tun, wenn 2sync eine Ratenbegrenzung erreicht?
Nein. 2sync behandelt Ratenbegrenzungen automatisch mit exponentiellem Backoff. Die Synchronisierung pausiert kurz und wird fortgesetzt, wenn die API es erlaubt. Es ist keine manuelle Aktion erforderlich.
Führen Ratenbegrenzungen zu Datenverlust?
Nein. Ratenbegrenzungen verlangsamen die Synchronisierung nur vorübergehend. Alle ausstehenden Änderungen werden in die Warteschlange gestellt und verarbeitet, sobald das Limit zurückgesetzt wird. Nichts wird übersprungen oder geht verloren.
Warum dauert meine erste Synchronisierung so lange?
Erste Synchronisierungen verarbeiten Ihre gesamte Datenbank innerhalb des konfigurierten Zeitfensters. Das kann Tausende von API-Aufrufen bedeuten, die Ratenbegrenzungen auslösen und mehrere Wiederholungszyklen erfordern können. Nachfolgende Synchronisierungen verarbeiten nur Änderungen und sind viel schneller.
Kann ich meine API-Ratenbegrenzungen erhöhen?
Ratenbegrenzungen werden von den API-Anbietern (Google, Microsoft, Notion) festgelegt, nicht von 2sync. 2sync arbeitet innerhalb dieser Limits und optimiert Anfragen, um die Auswirkungen zu minimieren. Es gibt keine Einstellung, um sie zu erhöhen.
Ich habe Ratenbegrenzungsprobleme mit Notion. Was kann ich tun?
Notion-Ratenbegrenzungen hängen von der Größe Ihrer Datenbank ab. Wenn Sie häufig auf Limits stoßen, reduzieren Sie die Anzahl synchronisierter Elemente, indem Sie Ihren Synchronisierungszeitraum eingrenzen oder Filter hinzufügen. Die meisten Synchronisierungen sind nach automatischen Wiederholungsversuchen erfolgreich, aber anhaltende Probleme mit sehr großen Datenbanken erfordern möglicherweise die Aufteilung der Daten auf mehrere Datenbanken.