Vai al contenuto principale
POST
curl
L’endpoint Refresh a Bank Connection di Didit richiede una sincronizzazione immediata e risponde con 202 e il sync_id. Invia "wait": true per attendere fino a 25 secondi e ottenere la sincronizzazione completata in una sola chiamata, senza costi aggiuntivi. La banca limita l’accesso non presidiato, quindi la chiamata può rispondere con 429 refresh_limit_reached e Retry-After. Vedi Aggiornare i dati bancari su richiesta.

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
Prefer
string

wait=<seconds> mantiene in attesa la chiamata per il numero di secondi indicato, al massimo 25, come wait: true nel corpo della richiesta.

Esempio:

"wait=25"

Parametri del percorso

id
string<uuid>
obbligatorio

L'id della connessione.

Corpo

application/json

Corpo facoltativo di un aggiornamento.

wait
boolean
predefinito:false

true tiene in attesa la chiamata per un massimo di 25 secondi e risponde 200 con la sincronizzazione completata, così una sola richiesta restituisce dati aggiornati. Se la banca non ha risposto entro quel tempo, la chiamata risponde 202: leggi la sincronizzazione con get_sync_run usando il sync_id, oppure iscriviti a bank.sync.completed. bank.data.updated arriva solo se la sincronizzazione memorizza modifiche. L'intestazione Prefer: wait=<seconds> (fino a 25) fa lo stesso.

Risposta

La sincronizzazione è terminata entro 25 secondi.

Una sincronizzazione terminata restituita da un aggiornamento con wait: l'esecuzione della sincronizzazione con il suo outcome, i conteggi per conto in results e balances_changed.

id
string<uuid>
obbligatorio
connection_id
string<uuid>
obbligatorio
trigger
enum<string>
obbligatorio
Opzioni disponibili:
initial,
scheduled,
requested
status
enum<string>
obbligatorio
Opzioni disponibili:
queued,
running,
succeeded,
partial,
failed
started_at
string<date-time> | null
obbligatorio
finished_at
string<date-time> | null
obbligatorio
results
object[]
obbligatorio

Cosa ha fatto l'esecuzione, per account e per risorsa.

error
object | null
obbligatorio

Perché l'esecuzione non è riuscita nel suo complesso. null quando non è così. Gli errori dei singoli conti e delle singole risorse si trovano in results.

outcome
enum<string>
obbligatorio

Come è terminata la sincronizzazione.

Opzioni disponibili:
succeeded,
partial,
failed
balances_changed
boolean
obbligatorio

Se un saldo è cambiato.

Ultima modifica il 22 novembre 2026