Saltar al contingut principal
GET
curl
L’endpoint Sync Transactions de Didit retorna els canvis produïts en les transaccions d’una connexió des d’un cursor: added, modified i removed. Un cursor buit retorna tot amb reset: true. Emmagatzema next_cursor només després d’una resposta amb has_more: false. Consulta Flux bancari continu per a la comptabilitat.

Autoritzacions

x-api-key
string
header
requerit

La clau d'API de la teva aplicació, des de Developers -> API keys a la Business Console. La clau principal té accés complet. Una clau amb nom es pot limitar: cap, lectura o escriptura per recurs, limitada a alguns fluxos de treball o a sessions aprovades, a una llista d'adreces IP i a una data de caducitat. 401 vol dir que la clau és incorrecta, revocada o caducada; 403 vol dir que no s'ha enviat cap clau, que la clau no té accés a aquest recurs o acció, o que la sol·licitud ve d'una adreça fora de la seva llista d'adreces IP; 404 en una ruta de sessió vol dir que la sessió queda fora dels fluxos de treball o estats de la clau. Una clau sense accés a multimèdia rep les URL d'imatges, vídeos i PDF com a null, i una clau sense escriptura de sessions rep els enllaços i els tokens de sessió com a null. Vegeu https://docs.didit.me/console/api-keys.

Paràmetres de ruta

id
string<uuid>
requerit

L'id de la connexió.

Paràmetres de consulta

cursor
string

El next_cursor que has emmagatzemat. Si està buit o s'omet, comença des del principi.

limit
integer
predeterminat:100

Mida de pàgina, de 1 a 500. Per defecte, 100.

Rang requerit: 1 <= x <= 500
page_token
string

Continua la mateixa lectura mentre has_more sigui true.

Resposta

Una pàgina de canvis.

Canvis de les transaccions d'una connexió des d'un cursor. Un cursor buit retorna totes les transaccions vigents com a added. Totes les pàgines d'una mateixa lectura reflecteixen la mateixa instantània; els canvis que arribin mentrestant es rebran en la lectura següent.

added
object[]
requerit

Transaccions per afegir. En una primera lectura (sense cursor, o després de reset) són totes les transaccions que tenia la connexió quan va començar la lectura, cadascuna exactament una vegada i en el seu estat actual, fins i tot si una sincronització s'executa mentre pagines. En lectures posteriors conté les transaccions noves des del teu cursor, i la transacció comptabilitzada que substitueix una de pendent.

modified
object[]
requerit

Transaccions que han canviat des del teu cursor, en el seu estat actual. Aplica cadascuna com a upsert per id: una transacció que ja has rebut mentre paginaves la primera lectura torna a aparèixer aquí si ha canviat entretant, i una correcció del banc també arriba aquí.

removed
object[]
requerit

Transaccions que ja no existeixen, amb un reason. Ignora un id que no tinguis: una transacció que s'ha eliminat mentre paginaves una primera lectura es va lliurar una vegada com a added i arriba en la lectura següent.

has_more
boolean
requerit

true mentre hi hagi més pàgines. Emmagatzema next_cursor només després d'una resposta amb has_more: false; si la paginació falla a mitjan camí, reinicia des del cursor que tenies emmagatzemat.

next_page_token
string | null
requerit

Continua aquesta lectura mentre has_more sigui true.

next_cursor
string | null
requerit

El punt de control durable del flux, que es retorna només a la darrera pàgina. És opac i està vinculat a l'aplicació, l'entorn i la connexió. Es pot reproduir durant 90 dies. En una primera lectura marca el moment en què va començar la lectura, de manera que els canvis que es produeixin mentrestant arribaran en la lectura següent.

reset
boolean
requerit

true en cada càrrega inicial, que és cada lectura des d'un cursor buit: substitueix la teva còpia pel resultat en lloc d'afegir-hi dades.

Darrera modificació el 22 de novembre del 2026