Zum Hauptinhalt springen
GET
curl
Der Endpoint Sync Transactions von Didit gibt zurück, was sich seit einem Cursor an den Transaktionen einer Verbindung geändert hat: added, modified und removed. Ein leerer Cursor gibt alle Transaktionen mit reset: true zurück. Speichern Sie next_cursor erst nach einer Antwort mit has_more: false. Siehe Kontinuierlicher Bank-Feed für die Buchhaltung.

Autorisierungen

x-api-key
string
header
erforderlich

Der API-Schlüssel Ihrer Anwendung, zu finden unter Developers -> API keys in der Business Console. Der primäre Schlüssel hat vollen Zugriff. Ein benannter Schlüssel kann eingeschränkt werden: pro Ressource keine, nur Lese- oder nur Schreibrechte, begrenzt auf einzelne Workflows oder nur auf genehmigte Sitzungen, auf eine Liste von IP-Adressen und auf ein Ablaufdatum. 401 bedeutet, dass der Schlüssel falsch, widerrufen oder abgelaufen ist. 403 bedeutet, dass kein Schlüssel gesendet wurde, der Schlüssel keinen Zugriff auf diese Ressource oder Aktion hat oder die Anfrage von einer Adresse außerhalb seiner IP-Liste kam. 404 bei einer Sitzungsroute bedeutet, dass die Sitzung außerhalb der Workflows oder Status des Schlüssels liegt. Ein Schlüssel ohne Medienzugriff erhält Bild-, Video- und PDF-URLs als null, und ein Schlüssel ohne Schreibzugriff auf Sitzungen erhält Sitzungslinks und Tokens als null. Siehe https://docs.didit.me/console/api-keys.

Pfadparameter

id
string<uuid>
erforderlich

Die Verbindungs-ID.

Abfrageparameter

cursor
string

Der gespeicherte next_cursor. Ist er leer oder fehlt er, beginnt die Abfrage am Anfang.

limit
integer
Standard:100

Seitengröße, 1 bis 500. Standard 100.

Erforderlicher Bereich: 1 <= x <= 500
page_token
string

Setzt dieselbe Abfrage fort, solange has_more true ist.

Antwort

Eine Seite mit Änderungen.

Änderungen an den Transaktionen einer Verbindung seit einem Cursor. Ein leerer Cursor gibt jede aktuelle Transaktion als added zurück. Alle Seiten einer Abfrage spiegeln denselben Snapshot wider; zwischenzeitliche Änderungen kommen beim nächsten Abruf.

added
object[]
erforderlich

Hinzuzufügende Transaktionen. Beim ersten Abruf (ohne Cursor oder nach reset) sind dies alle Transaktionen, die die Verbindung beim Start des Abrufs hatte, jeweils genau einmal und in ihrem aktuellen Stand, auch wenn während des Paginierens eine Synchronisierung läuft. In späteren Abrufen enthält es die Transaktionen, die seit Ihrem Cursor neu sind, sowie die gebuchte Transaktion, die eine ausstehende ersetzt.

modified
object[]
erforderlich

Transaktionen, die sich seit Ihrem Cursor geändert haben, in ihrem aktuellen Stand. Wenden Sie jede als Upsert anhand von id an: Eine Transaktion, die Sie bereits beim Paginieren des ersten Abrufs erhalten haben, kommt hier erneut, wenn sie sich inzwischen geändert hat, und auch eine Korrektur der Bank trifft hier ein.

removed
object[]
erforderlich

Transaktionen, die nicht mehr existieren, mit einem reason. Ignorieren Sie eine id, die Sie nicht haben: Eine Transaktion, die während des Paginierens eines ersten Abrufs entfernt wurde, wurde dennoch einmal als added ausgeliefert und trifft im nächsten Abruf hier ein.

has_more
boolean
erforderlich

true, solange weitere Seiten vorhanden sind. Speichern Sie next_cursor erst nach einer Antwort mit has_more: false. Schlägt das Paging mittendrin fehl, starten Sie neu ab dem Cursor, den Sie zuvor gespeichert hatten.

next_page_token
string | null
erforderlich

Setzt diese Abfrage fort, solange has_more true ist.

next_cursor
string | null
erforderlich

Der dauerhafte Checkpoint des Feeds, der nur auf der letzten Seite zurückgegeben wird. Opak und an Anwendung, Umgebung und Verbindung gebunden. Für 90 Tage wiederholbar. Beim ersten Lesen markiert er den Zeitpunkt, zu dem das Lesen begann, sodass Änderungen, die inzwischen erfolgt sind, beim nächsten Lesen ankommen.

reset
boolean
erforderlich

true bei jedem Erstabruf, also bei jedem Abruf mit leerem Cursor: Ersetzen Sie Ihre Kopie durch das Ergebnis, statt das Ergebnis daran anzuhängen.

Zuletzt geändert am 22. November 2026