Vai al contenuto principale
GET
curl
L’endpoint Get a Sync Run di Didit restituisce una sincronizzazione con il relativo risultato per ogni account e risorsa: i conteggi di elementi aggiunti, modificati e rimossi, oppure l’errore. Il sync_id proviene da Aggiorna una connessione oppure dal webhook bank.data.updated.

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.

Parametri del percorso

id
string<uuid>
obbligatorio

L'id della connessione.

sync_id
string<uuid>
obbligatorio

L'id dell'esecuzione della sincronizzazione.

Risposta

L'esecuzione della sincronizzazione.

Una sincronizzazione di una connessione. Sono elencate solo le sincronizzazioni iniziali, programmate e richieste.

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.

Ultima modifica il 22 novembre 2026