Mit Sync Now ruft Didit über einen einzigen Aufruf jederzeit die neuesten Daten einer Verbindung bei der Bank ab.
Live-Syncs sind im monatlichen Preis der Verbindung enthalten, es fallen also keine zusätzlichen Kosten an.
Das einzige Limit legt die Bank fest.
Die automatische Synchronisierung
- Die erste Synchronisierung läuft, sobald die Person die Verbindung herstellt.
- Danach synchronisiert sich jede aktive, laufende Verbindung automatisch ein- bis viermal am Tag, je nach Bank.
sync.frequency_per_day an der Verbindung gibt an, wie oft, und sync.next_sync_at den Zeitpunkt der nächsten Synchronisierung.
- Wenn die Bank mehr unbeaufsichtigte Lesezugriffe pro Tag zulässt, bleiben immer mindestens zwei am Tag für Live-Synchronisierungen reserviert.
- Wenn eine Synchronisierung Änderungen speichert, wird
bank.data.updated gesendet, und Sie lesen mit Ihrem Cursor den Änderungsfeed.
- Eine fehlgeschlagene Synchronisierung wird mit Backoff erneut versucht. Nach 24 Stunden mit Fehlschlägen bleibt die Verbindung
active mit sync.status: failing, und bank.sync.failed wird gesendet. Wenn es wieder funktioniert, folgt bank.sync.recovered.
- Fordert die Bank die Person auf, sich erneut anzumelden, wechselt die Verbindung in den Status
renewal_required.
Jetzt in einem Aufruf synchronisieren
Fügen Sie "wait": true hinzu. Dann liefert eine einzige Anfrage frische Daten:
Der Header Prefer: wait=25 bewirkt dasselbe.
Der Aufruf wartet bis zu 25 Sekunden:
Läuft bereits eine Synchronisierung, erhalten Sie dieselbe sync_id zurück, nicht einen zweiten Auftrag.
Nach einer 200-Antwort oder einem bank.data.updated lesen Sie den Änderungsfeed mit Ihrem gespeicherten Cursor.
Was eine Synchronisierung bewirkt hat, lesen Sie später mit get_sync_run.
Der Preis
Automatische Synchronisierungen und Live-Synchronisierungen sind im monatlichen Preis der Verbindung enthalten, siehe Preise.
Eine Live-Synchronisierung verursacht niemals zusätzliche Kosten.
Das tägliche Limit der Bank
Eine Bank begrenzt, wie oft Daten ohne Anwesenheit der Person abgerufen werden können.
Europäische Vorgaben erlauben einer Bank, den Zugriff ohne Anwesenheit auf vier Abfragen pro Konto und Tag zu begrenzen.
Das ist eine Obergrenze und kein Versprechen: Eine Bank kann weniger erlauben oder auch mehr zusagen.
- Automatische und Live-Synchronisierungen teilen sich ein Kontingent, und der automatische Zeitplan verbraucht nie die letzten beiden Abfragen eines Tages.
sync.live_syncs_left_today auf der Verbindung zeigt, wie viele Live-Synchronisierungen heute noch verbleiben, und sync.budgets[] zeigt jedes Kontingent: scope (connection oder account), resource, limit, remaining und resets_at.
- Solange die Person in Bank Link anwesend ist, etwa für eine Verlängerung oder eine erneute Verbindung, sind Abfragen nicht begrenzt.
- Ist das Tageskontingent aufgebraucht, antwortet der Aufruf mit
429 refresh_limit_reached, einem Retry-After-Header (die Sekunden bis zum Zurücksetzen des Kontingents) und einem sync-Objekt mit live_syncs_left_today und budgets. Warten Sie so lange und verlassen Sie sich in der Zwischenzeit auf die automatische Synchronisierung.
- Ihre API-Limits sind davon getrennt: 600 Abfragen und 300 Schreibvorgänge pro Minute und Anwendung, mit
X-RateLimit-*-Headern.
Wie aktuell die Daten sind
sync.last_synced_at an der Verbindung und an jedem Konto gibt an, wann Didit zuletzt Daten von der Bank abgerufen hat, nicht, wann Sie die Daten zuletzt gelesen haben.
- Beide Transaktionsabfragen liefern
X-Bank-Last-Synced-At zurück.
Fehler, die Sie behandeln sollten
Verwandte Themen
Zuletzt geändert am 22. November 2026