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

A sincronização automática

  • A primeira sincronização é executada quando a pessoa estabelece a ligação.
  • Depois disso, cada ligação contínua ativa sincroniza automaticamente entre uma e quatro vezes por dia, consoante o banco. sync.frequency_per_day na ligação indica quantas, e sync.next_sync_at indica quando está prevista a seguinte.
  • Quando o banco permite mais leituras automáticas por dia, pelo menos duas por dia ficam sempre reservadas para sincronizações em tempo real.
  • Quando uma sincronização grava alterações, é enviado bank.data.updated e lê o feed de alterações com o seu cursor.
  • Uma sincronização que falha é tentada novamente com um intervalo progressivo. Após 24 horas de falhas, a ligação mantém-se active com sync.status: failing, e é enviado bank.sync.failed. Quando volta a funcionar, é enviado bank.sync.recovered.
  • Quando o banco pede à pessoa que volte a iniciar sessão, a ligação passa para renewal_required.

Sincronizar agora, numa só chamada

Adicione "wait": true e um pedido devolve dados atualizados:
O cabeçalho Prefer: wait=25 faz o mesmo. A chamada aguarda até 25 segundos:
Se uma sincronização já estiver em curso, 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 guardado. Consulte mais tarde o que uma sincronização fez com get_sync_run.

O preço

As sincronizações automáticas e as sincronizações em tempo real estão ambas incluídas no preço mensal da ligação, ver preços. Uma sincronização em tempo real nunca acrescenta custos.

O limite diário do banco

Um banco limita a frequência com que os dados podem ser obtidos sem a presença da pessoa. As regras europeias permitem que um banco limite o acesso sem a presença da pessoa a quatro leituras por dia, por conta. Trata-se de um teto, não de uma garantia: um banco pode permitir menos ou aceitar mais.
  • As sincronizações automáticas e em tempo real partilham o mesmo orçamento, e o agendamento automático nunca utiliza as duas últimas leituras do dia.
  • sync.live_syncs_left_today na ligação indica quantas sincronizações em tempo real restam hoje, e sync.budgets[] mostra cada bloco: 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 o orçamento do dia se esgota, a chamada responde com 429 refresh_limit_reached, com um cabeçalho Retry-After (os segundos até ao orçamento ser reposto) e um objeto sync com live_syncs_left_today e budgets. Aguarde esse tempo e, entretanto, conte com a sincronização automática.
  • Os limites da sua API são separados: 600 leituras e 300 escritas por minuto, por aplicação, com cabeçalhos X-RateLimit-*.

Saber quão atualizados estão os dados

  • sync.last_synced_at na ligação e em cada conta indica quando a Didit foi buscar os dados ao banco pela última vez, e não quando os leu pela última vez.
  • Ambas as consultas de transações devolvem X-Bank-Last-Synced-At.

Erros que deve tratar

Relacionados

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