Saltar al contingut principal
La funció Sync Now de Didit llegeix les dades més recents d’una connexió al banc en qualsevol moment, amb una sola crida. Les sincronitzacions en directe estan incloses en el preu mensual de la connexió: no es cobra res addicional. L’única limitació és la del banc.

La sincronització automàtica

  • La primera sincronització s’executa quan la persona es connecta.
  • Després, cada connexió contínua activa se sincronitza automàticament entre una i quatre vegades al dia, segons el banc. sync.frequency_per_day a la connexió indica quantes són, i sync.next_sync_at, quan està prevista la següent.
  • Quan el banc permet més lectures al dia sense intervenció de la persona, sempre en queden almenys dues al dia reservades per a sincronitzacions en directe.
  • Quan una sincronització emmagatzema canvis, arriba bank.data.updated i tu llegeixes el feed de canvis amb el teu cursor.
  • Una sincronització que falla es reintenta amb retard progressiu. Després de 24 hores de fallades, la connexió es manté active amb sync.status: failing, i s’envia bank.sync.failed. Quan torna a funcionar, arriba bank.sync.recovered.
  • Quan el banc demana a la persona que torni a iniciar sessió, la connexió passa a renewal_required.

Sincronitza ara, en una sola crida

Afegeix "wait": true i una sola petició retorna dades actualitzades:
La capçalera Prefer: wait=25 fa el mateix. La crida espera fins a 25 segons:
Si ja hi ha una sincronització en curs, obtens aquest mateix sync_id, no una segona tasca. Després d’un 200 o d’un bank.data.updated, llegeix el canal de canvis amb el cursor que has desat. Per llegir més tard què ha fet una sincronització, usa get_sync_run.

El preu

Les sincronitzacions automàtiques i les sincronitzacions en directe estan incloses en el preu mensual de la connexió. Consulta preus. Una sincronització en directe mai no suposa cap càrrec addicional.

El límit diari del banc

Un banc limita amb quina freqüència es poden obtenir dades sense la presència de la persona. Les normes europees permeten que un banc limiti l’accés desatès a quatre lectures al dia per compte. Es tracta d’un sostre, no d’una promesa: un banc pot permetre-n’hi menys o acordar-ne més.
  • Les sincronitzacions automàtiques i les en directe comparteixen un mateix pressupost, i la programació automàtica mai no utilitza les dues últimes lectures del dia.
  • sync.live_syncs_left_today a la connexió indica quantes sincronitzacions en directe queden avui, i sync.budgets[] mostra cada grup: scope (connection o account), resource, limit, remaining i resets_at.
  • Mentre la persona és present a Bank Link, per a una renovació o una reconnexió, les lectures no tenen límit.
  • Quan s’ha esgotat el pressupost del dia, la crida respon amb 429 refresh_limit_reached, amb una capçalera Retry-After (els segons que falten fins que el pressupost es reinicia) i un objecte sync amb live_syncs_left_today i budgets. Espera aquest temps i confia en la sincronització automàtica mentrestant.
  • Els límits de la teva API són independents: 600 lectures i 300 escriptures per minut per aplicació, amb capçaleres X-RateLimit-*.

Saber com d’actualitzades són les dades

  • sync.last_synced_at a la connexió i a cada compte és el moment en què Didit va obtenir les dades del banc per última vegada, i no el moment en què tu les vas llegir per última vegada.
  • Les dues lectures de transaccions retornen X-Bank-Last-Synced-At.

Errors que has de gestionar

Relacionats

Darrera modificació el 22 de novembre del 2026