Pular para o conteúdo principal
O Sync Now lê os dados mais recentes de uma conexão no banco a qualquer momento, com uma única chamada. As sincronizações em tempo real estão incluídas no preço mensal da conexão: nenhum valor extra é cobrado. O único limite é o do banco.

A sincronização automática

  • A primeira sincronização é executada quando a pessoa se conecta.
  • Depois disso, cada conexão ativa e contínua é sincronizada automaticamente entre uma e quatro vezes por dia, dependendo do banco. sync.frequency_per_day na conexão indica quantas, e sync.next_sync_at indica quando a próxima está prevista.
  • Quando o banco permite mais leituras sem intervenção por dia, sempre restam pelo menos duas por dia para sincronizações ao vivo.
  • Quando uma sincronização armazena alterações, bank.data.updated é enviado e você lê o feed de alterações usando seu cursor.
  • Uma sincronização que falha é tentada novamente com backoff. Após 24 horas de falhas, a conexão permanece active com sync.status: failing, e bank.sync.failed é enviado. bank.sync.recovered é enviado quando ela volta a funcionar.
  • Quando o banco pede que a pessoa entre novamente, a conexão passa para renewal_required.

Sincronizar agora, em uma chamada

Adicione "wait": true e uma única requisição retorna dados atualizados:
O cabeçalho Prefer: wait=25 faz o mesmo. A chamada aguarda por até 25 segundos:
Se uma sincronização já estiver em andamento, você recebe o mesmo sync_id, e não uma segunda tarefa. Depois de um 200 ou de um bank.data.updated, leia o feed de alterações com o cursor que você armazenou. Leia depois o que uma sincronização fez com get_sync_run.

Preço

As sincronizações automáticas e as sincronizações ao vivo estão incluídas no preço mensal da conexão. Veja preços. Uma sincronização ao vivo nunca gera cobrança extra.

O limite diário do banco

Um banco limita a frequência com que os dados podem ser buscados sem a presença da pessoa. As regras europeias permitem que um banco limite o acesso sem supervisão a quatro leituras por dia por conta. Esse é um teto, não uma promessa: um banco pode permitir menos ou aceitar mais.
  • As sincronizações automáticas e ao vivo compartilham a mesma cota, e a programação automática nunca usa as últimas duas leituras do dia.
  • sync.live_syncs_left_today na conexão indica quantas sincronizações ao vivo restam hoje, e sync.budgets[] mostra cada cota: scope (connection ou account), resource, limit, remaining e resets_at.
  • Enquanto a pessoa estiver presente no Bank Link, para uma renovação ou uma reconexão, as leituras não são limitadas.
  • Quando a cota do dia se esgota, a chamada responde 429 refresh_limit_reached com um cabeçalho Retry-After (os segundos até a cota ser reiniciada) e um objeto sync com live_syncs_left_today e budgets. Aguarde esse tempo e, nesse meio-tempo, conte com a sincronização automática.
  • Os limites da sua API são separados: 600 leituras e 300 gravações por minuto por aplicação, com cabeçalhos X-RateLimit-*.

Saiba o quão atualizados estão os dados

  • sync.last_synced_at na conexão e em cada conta indica quando a Didit buscou dados pela última vez no banco, e não quando você os leu pela última vez.
  • As duas leituras de transações retornam X-Bank-Last-Synced-At.

Erros que você deve tratar

Relacionados

Última modificação em 22 de novembro de 2026