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