Vai al contenuto principale
DELETE
curl
L’endpoint di Didit per eliminare una connessione bancaria interrompe l’accesso presso la banca ed elimina i conti, i saldi e le transazioni memorizzati per la connessione. L’eliminazione è irreversibile. Per interrompere l’accesso senza eliminare, usa la revoca. Consulta Dati, consenso ed eliminazione per sapere quali elementi sono interessati e quali no.

Autorizzazioni

x-api-key
string
header
obbligatorio

La chiave API della tua applicazione, da Developers -> API keys nella Business Console. La chiave primaria ha accesso completo. Una chiave con nome può avere ambiti limitati: nessuno, lettura o scrittura per risorsa, limitata ad alcuni workflow o solo alle sessioni approvate, a un elenco di indirizzi IP e a una data di scadenza. 401 significa che la chiave è errata, revocata o scaduta; 403 significa che non è stata inviata alcuna chiave, che la chiave non ha accesso a questa risorsa o azione, oppure che la richiesta proviene da un indirizzo esterno alla sua lista IP; 404 su una route di sessione significa che la sessione è al di fuori dei workflow o degli stati consentiti alla chiave. Una chiave senza accesso ai media riceve gli URL di immagini, video e PDF come null, e una chiave senza permesso di scrittura sulle sessioni riceve i link e i token delle sessioni come null. Vedi https://docs.didit.me/console/api-keys.

Intestazioni

Idempotency-Key
string

Chiave facoltativa per la sicurezza dei nuovi tentativi, da scegliere per una singola operazione, fino a 255 caratteri (va bene un UUID). Una richiesta ripetuta con la stessa chiave, lo stesso endpoint, la stessa query e lo stesso body riceve la prima risposta, con lo stesso status e lo stesso body, e non viene eseguita né fatturata una seconda volta. Con la stessa chiave ma un altro endpoint, query o body viene restituito 409 idempotency_key_reused; mentre la prima richiesta è ancora in esecuzione, viene restituito 409 idempotency_key_in_progress con Retry-After. Una richiesta non riuscita (qualsiasi 4xx o 5xx) non viene memorizzata, quindi puoi inviarla di nuovo con la stessa chiave. Le chiavi appartengono alla tua applicazione, sia che tu chiami con una chiave API sia con un token di accesso. Vedi Nuovi tentativi e idempotenza.

Required string length: 1 - 255

Parametri del percorso

id
string<uuid>
obbligatorio

L'id della connessione.

Risposta

Eliminazione accettata.

Cancellazione accettata. I dati bancari della connessione sono in fase di eliminazione e le sue operazioni sui dati rispondono 409 connection_not_active; la lettura della connessione restituisce un record minimo con questo stato erasure.

id
string<uuid>
obbligatorio

L'id della connessione.

erasure
object
obbligatorio

Avanzamento di una cancellazione richiesta da te.

Ultima modifica il 22 novembre 2026