Zum Hauptinhalt springen
GET
curl
Der „List Sync Runs“-Endpoint gibt die Sync-Läufe einer Verbindung mit Auslöser, Status und Zeitpunkten zurück. Verwenden Sie ihn, um zu sehen, ob ein Sync-Lauf initial, scheduled oder requested war und ob er erfolgreich war. Einen einzelnen davon rufen Sie mit Einen Sync-Lauf abrufen ab.

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

limit
integer
Standard:100

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

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

Opaker Cursor aus dem next_cursor der vorherigen Seite.

Antwort

Eine Seite mit Synchronisierungsläufen.

items
object[]
erforderlich
next_cursor
string | null
erforderlich
Zuletzt geändert am 22. November 2026