Vai al contenuto principale
Il Sync Now di Didit legge in qualsiasi momento dalla banca i dati più recenti relativi a una connessione, con una sola chiamata. Le sincronizzazioni in tempo reale sono incluse nel prezzo mensile della connessione: non viene addebitato nulla in più. L’unico limite è quello della banca.

La sincronizzazione automatica

  • La prima sincronizzazione viene eseguita quando la persona si connette.
  • Successivamente, ogni connessione continuativa attiva si sincronizza automaticamente da una a quattro volte al giorno, a seconda della banca. sync.frequency_per_day sulla connessione indica quante volte, e sync.next_sync_at indica quando è pianificata la successiva.
  • Dove la banca consente più letture senza intervento dell’utente al giorno, almeno due al giorno restano sempre riservate alle sincronizzazioni in tempo reale.
  • Quando una sincronizzazione salva delle modifiche, arriva bank.data.updated e tu leggi il flusso delle modifiche con il tuo cursore.
  • Una sincronizzazione non riuscita viene ritentata con backoff. Dopo 24 ore di errori la connessione resta active con sync.status: failing, e viene inviato bank.sync.failed. bank.sync.recovered arriva quando torna a funzionare.
  • Quando la banca chiede alla persona di effettuare di nuovo l’accesso, la connessione passa a renewal_required.

Sincronizza ora, con una sola chiamata

Aggiungi "wait": true e una richiesta restituisce dati aggiornati:
L’intestazione Prefer: wait=25 fa lo stesso. La chiamata attende fino a 25 secondi:
Se una sincronizzazione è già in corso, ottieni lo stesso sync_id, non un secondo job. Dopo un 200 o un bank.data.updated, leggi il feed delle modifiche con il cursore memorizzato. Per leggere in seguito cosa ha fatto una sincronizzazione, usa get_sync_run.

Il prezzo

Le sincronizzazioni automatiche e quelle live sono entrambe incluse nel prezzo mensile della connessione, vedi prezzi. Una sincronizzazione live non aggiunge mai costi.

Il limite giornaliero della banca

Una banca limita la frequenza con cui i dati possono essere recuperati senza la presenza della persona. Le norme europee consentono alla banca di limitare l’accesso non presidiato a quattro letture al giorno per account. Si tratta di un tetto massimo, non di una garanzia: una banca può consentirne meno o accettarne di più.
  • Le sincronizzazioni automatiche e quelle in tempo reale condividono lo stesso budget, e la pianificazione automatica non utilizza mai le ultime due letture della giornata.
  • sync.live_syncs_left_today sulla connessione indica quante sincronizzazioni in tempo reale restano per oggi, mentre sync.budgets[] mostra ciascun contenitore: scope (connection o account), resource, limit, remaining e resets_at.
  • Mentre la persona è presente in Bank Link, per un rinnovo o una riconnessione, le letture non sono soggette a limiti.
  • Quando il budget giornaliero è esaurito, la chiamata risponde con 429 refresh_limit_reached e con un’intestazione Retry-After (i secondi che mancano al ripristino del budget), oltre a un oggetto sync con live_syncs_left_today e budgets. Attendi quel tempo e nel frattempo affidati alla sincronizzazione automatica.
  • I limiti delle API sono separati: 600 letture e 300 scritture al minuto per applicazione, con le intestazioni X-RateLimit-*.

Scopri quanto sono aggiornati i dati

  • sync.last_synced_at sulla connessione e su ogni conto indica quando Didit ha recuperato l’ultima volta i dati dalla banca, non il momento in cui li hai letti tu.
  • Entrambe le letture delle transazioni restituiscono X-Bank-Last-Synced-At.

Errori da gestire

Correlati

Ultima modifica il 22 novembre 2026