> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Bankdaten aktualisieren: Sync Now auf Abruf

> Mit Didit aktuelle Bankdaten einer Verbindung per Aufruf jederzeit abrufen, das Ergebnis abwarten, das tägliche Bank-Limit und die 429-Antwort kennen.

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](https://docs.didit.me/de/standalone-apis/bank-transactions-sync.md).
* 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:

```bash theme={null}
curl -X POST https://verification.didit.me/v3/bank/connections/$CONNECTION_ID/refresh/ \
  -H "x-api-key: $DIDIT_API_KEY" -H "content-type: application/json" \
  -d '{ "wait": true }'
```

Der Header `Prefer: wait=25` bewirkt dasselbe.
Der Aufruf wartet bis zu 25 Sekunden:

| Antwort | Bedeutung |
| - | - |
| `200` | Die Synchronisierung ist abgeschlossen. Der Body enthält die Synchronisierung mit ihrem `outcome`, den pro Konto erfassten Anzahlen für `added`, `modified` und `removed` sowie `balances_changed`. |
| `202` | Die Bank hat nach 25 Sekunden nicht geantwortet, oder Sie haben keine Wartezeit angefordert. Der Body enthält die `sync_id`: Lesen Sie die Synchronisierung mit `get_sync_run` aus, oder abonnieren Sie `bank.sync.completed`. `bank.data.updated` folgt nur, wenn die Synchronisierung Änderungen speichert. |

```json theme={null}
{
  "id": "d4a9e7b2-1c58-4f03-96ab-5e2d8c7f0b14",
  "trigger": "requested",
  "status": "succeeded",
  "outcome": "succeeded",
  "balances_changed": true,
  "results": [{ "resource": "transactions", "outcome": "succeeded", "added": 3, "modified": 0, "removed": 1 }]
}
```

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`](https://docs.didit.me/de/standalone-apis/bank-sync-run-get).

## Der Preis

Automatische Synchronisierungen und Live-Synchronisierungen sind im monatlichen Preis der Verbindung enthalten, siehe [Preise](https://docs.didit.me/de/getting-started/bank-verification-pricing.md).
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

| Fehler | Bedeutung | Maßnahme |
| - | - | - |
| `429 refresh_limit_reached` | Das Budget der Bank ist ausgeschöpft. | Warten Sie `Retry-After` ab und verlassen Sie sich auf die automatische Synchronisierung. |
| `409 connection_not_active` | Die Verbindung ist nicht `active`. | Prüfen Sie deren Status. |
| `409 consent_expired` | Die Einwilligung ist abgelaufen. | [Erneuern Sie sie](https://docs.didit.me/de/use-cases/renew-bank-consent.md). |

## Verwandte Themen

* [Kontinuierlicher Bankdaten-Feed für die Buchhaltung](https://docs.didit.me/de/use-cases/bank-data-for-accounting.md)
* [Bank-Webhooks](https://docs.didit.me/de/core-technology/bank-verification/webhooks.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.