Zum Hauptinhalt springen
DELETE
curl
Der Endpoint „Bankverbindung löschen“ von Didit beendet den Zugriff bei der Bank und löscht die gespeicherten Konten, Guthaben und Transaktionen der Verbindung. Die Löschung ist unwiderruflich. Um den Zugriff zu beenden, ohne zu löschen, verwenden Sie Widerrufen. Welche Daten betroffen sind und welche nicht, erfahren Sie unter Daten, Einwilligung und Löschung.

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.

Header

Idempotency-Key
string

Optionaler Schlüssel zur Wiederholungssicherheit für einen Vorgang, den Sie selbst wählen, bis zu 255 Zeichen (eine UUID eignet sich). Eine Anfrage, die mit demselben Schlüssel, demselben Endpoint, denselben Query-Parametern und demselben Body wiederholt wird, erhält die erste Antwort mit demselben Status und demselben Body zurück und wird kein zweites Mal ausgeführt oder berechnet. Derselbe Schlüssel mit einem anderen Endpoint, anderen Query-Parametern oder einem anderen Body liefert 409 mit idempotency_key_reused. Solange die erste Anfrage noch läuft, liefert er 409 mit idempotency_key_in_progress und Retry-After. Eine fehlgeschlagene Anfrage (jeder 4xx- oder 5xx-Fehler) wird nicht gespeichert, sodass Sie sie mit demselben Schlüssel erneut senden können. Schlüssel gehören zu Ihrer Anwendung, unabhängig davon, ob Sie mit einem API-Schlüssel oder einem Zugriffstoken aufrufen. Siehe Wiederholungsversuche und Idempotenz.

Required string length: 1 - 255

Pfadparameter

id
string<uuid>
erforderlich

Die Verbindungs-ID.

Antwort

Löschung angenommen.

Akzeptierte Löschung. Die Bankdaten der Verbindung werden gelöscht, und ihre Datenoperationen antworten mit 409 connection_not_active. Das Auslesen der Verbindung liefert einen minimalen Datensatz mit diesem erasure-Status.

id
string<uuid>
erforderlich

Die Verbindungs-ID.

erasure
object
erforderlich

Fortschritt einer von Ihnen angeforderten Löschung.

Zuletzt geändert am 22. November 2026