Passer au contenu principal
GET
curl
L’endpoint Sync Transactions de Didit renvoie les modifications apportées aux transactions d’une connexion depuis un curseur : added, modified et removed. Un curseur vide renvoie l’intégralité des données avec reset: true. Ne stockez next_cursor qu’après une réponse contenant has_more: false. Voir Flux bancaire continu pour la comptabilité.

Autorisations

x-api-key
string
header
requis

La clé API de votre application, disponible dans Developers -> API keys de la Business Console. La clé principale a un accès complet. Une clé nommée peut être limitée : aucun accès, lecture ou écriture par ressource, restreinte à certains workflows ou à certaines sessions approuvées, à une liste d'adresses IP et à une date d'expiration. 401 signifie que la clé est incorrecte, révoquée ou expirée ; 403 signifie qu'aucune clé n'a été envoyée, que la clé n'a pas accès à cette ressource ou à cette action, ou que la requête provient d'une adresse hors de sa liste d'adresses IP ; 404 sur une route de session signifie que la session se trouve hors des workflows ou des statuts de la clé. Une clé sans accès aux médias reçoit les URL des images, vidéos et PDF à null, et une clé sans accès en écriture aux sessions reçoit les liens et tokens de session à null. Voir https://docs.didit.me/console/api-keys.

Paramètres de chemin

id
string<uuid>
requis

L'identifiant de la connexion.

Paramètres de requête

cursor
string

Le next_cursor que vous avez stocké. Vide ou omis : la lecture commence au début.

limit
integer
défaut:100

Taille de page, de 1 à 500. Par défaut 100.

Plage requise: 1 <= x <= 500
page_token
string

Poursuit la même lecture tant que has_more vaut true.

Réponse

Une page de modifications.

Modifications des transactions d'une connexion depuis un curseur. Un curseur vide renvoie toutes les transactions actuelles comme added. Toutes les pages d'une même lecture reflètent le même instantané ; les modifications survenues entre-temps arrivent à la lecture suivante.

added
object[]
requis

Transactions à ajouter. Lors d'une première lecture (sans curseur, ou après reset), il s'agit de toutes les transactions que la connexion possédait au début de la lecture, chacune une seule fois et dans son état actuel, même si une synchronisation s'exécute pendant la pagination. Lors des lectures suivantes, elle contient les transactions nouvelles depuis votre curseur, ainsi que la transaction comptabilisée qui remplace une transaction en attente.

modified
object[]
requis

Transactions modifiées depuis votre curseur, dans leur état actuel. Appliquez chacune comme une insertion ou mise à jour selon id : une transaction déjà reçue pendant la pagination d'une première lecture revient ici si elle a changé entre-temps, et une correction de la banque arrive aussi ici.

removed
object[]
requis

Transactions qui n'existent plus, avec un reason. Ignorez un id que vous ne possédez pas : une transaction supprimée pendant la pagination d'une première lecture a été livrée une fois en tant qu'added et figurera dans la lecture suivante.

has_more
boolean
requis

true tant qu'il reste des pages. Enregistrez next_cursor uniquement après une réponse avec has_more: false ; si la pagination échoue en cours de route, recommencez depuis le curseur que vous aviez enregistré.

next_page_token
string | null
requis

Poursuit cette lecture tant que has_more vaut true.

next_cursor
string | null
requis

Le point de contrôle durable du flux, renvoyé uniquement sur la dernière page. Opaque et lié à l'application, à l'environnement et à la connexion. Rejouable pendant 90 jours. Lors d'une première lecture, il marque le moment où la lecture a commencé, de sorte que les modifications survenues entre-temps arrivent à la lecture suivante.

reset
boolean
requis

true à chaque initialisation, c'est-à-dire à chaque lecture depuis un curseur vide : remplacez votre copie par le résultat au lieu de l'ajouter.

Dernière modification le 22 novembre 2026