Vai al contenuto principale
GET
curl
L’endpoint Sync Transactions di Didit restituisce le modifiche alle transazioni di una connessione a partire da un cursore: added, modified e removed. Un cursore vuoto restituisce tutti i dati con reset: true. Salva next_cursor solo dopo una risposta con has_more: false. Vedi Feed bancario continuo per la contabilità.

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.

Parametri della query

cursor
string

Il next_cursor salvato. Se vuoto o omesso, si parte dall'inizio.

limit
integer
predefinito:100

Dimensione della pagina, da 1 a 500. Predefinito: 100.

Intervallo richiesto: 1 <= x <= 500
page_token
string

Prosegue la stessa lettura finché has_more è true.

Risposta

Una pagina di modifiche.

Modifiche alle transazioni di una connessione a partire da un cursore. Un cursore vuoto restituisce tutte le transazioni correnti come added. Tutte le pagine di una stessa lettura riflettono lo stesso snapshot; le modifiche che arrivano nel frattempo compaiono nella lettura successiva.

added
object[]
obbligatorio

Transazioni da aggiungere. Nella prima lettura (senza cursore, o dopo reset) contiene tutte le transazioni che la connessione aveva all'avvio della lettura, ciascuna una sola volta e nel suo stato attuale, anche se una sincronizzazione viene eseguita mentre paginavi. Nelle letture successive contiene le transazioni nuove dal tuo cursore e la transazione contabilizzata che sostituisce una in sospeso.

modified
object[]
obbligatorio

Transazioni cambiate dal tuo cursore, nel loro stato attuale. Applicale come upsert tramite id: una transazione già ricevuta durante la paginazione della prima lettura viene inviata di nuovo qui se nel frattempo è cambiata, e anche una correzione della banca arriva qui.

removed
object[]
obbligatorio

Transazioni che non esistono più, con un reason. Ignora un id che non hai: una transazione rimossa mentre paginavi una prima lettura è stata consegnata una volta come added e arriva qui nella lettura successiva.

has_more
boolean
obbligatorio

true finché ci sono altre pagine. Memorizza next_cursor solo dopo una risposta con has_more: false; se la paginazione si interrompe a metà, ricomincia dal cursore che avevi memorizzato.

next_page_token
string | null
obbligatorio

Prosegue questa lettura finché has_more è true.

next_cursor
string | null
obbligatorio

Il checkpoint durevole del feed, restituito solo nell'ultima pagina. Opaco e vincolato all'applicazione, all'ambiente e alla connessione. Riproducibile per 90 giorni. In una prima lettura segna il momento in cui la lettura è iniziata, quindi ciò che è cambiato nel frattempo arriva nella lettura successiva.

reset
boolean
obbligatorio

true in ogni bootstrap, cioè in ogni lettura da un cursore vuoto: sostituisci la tua copia con il risultato invece di aggiungerlo.

Ultima modifica il 22 novembre 2026