Saltar para o conteúdo principal
GET
curl
O endpoint Sync Transactions da Didit devolve as alterações nas transações de uma ligação desde um cursor: added, modified e removed. Um cursor vazio devolve tudo com reset: true. Guarde next_cursor apenas depois de uma resposta com has_more: false. Consulte Fluxo bancário contínuo para contabilidade.

Autorizações

x-api-key
string
header
obrigatório

A chave de API da sua aplicação, obtida em Developers -> API keys na Business Console. A chave principal tem acesso total. Uma chave com nome pode ter o âmbito limitado: nenhum, leitura ou escrita por recurso, limitada a alguns fluxos ou apenas a sessões aprovadas, a uma lista de endereços IP e a uma data de validade. 401 significa que a chave está errada, revogada ou expirada; 403 significa que não foi enviada nenhuma chave, que a chave não tem acesso a este recurso ou ação, ou que o pedido veio de um endereço fora da sua lista de IP; 404 numa rota de sessão significa que a sessão está fora dos fluxos ou estados da chave. Uma chave sem acesso a multimédia recebe os URLs de imagem, vídeo e PDF como null, e uma chave sem escrita em sessões recebe os links e tokens de sessão como null. Consulte https://docs.didit.me/console/api-keys.

Parâmetros de caminho

id
string<uuid>
obrigatório

O id da ligação.

Parâmetros de consulta

cursor
string

O next_cursor que guardou. Vazio ou omitido começa desde o início.

limit
integer
padrão:100

Tamanho da página, de 1 a 500. Predefinição 100.

Intervalo necessário: 1 <= x <= 500
page_token
string

Continua a mesma leitura enquanto has_more for true.

Resposta

Uma página de alterações.

Alterações nas transações de uma conexão desde um cursor. Um cursor vazio devolve todas as transações atuais como added. Todas as páginas de uma leitura refletem o mesmo instantâneo; as alterações que chegarem entretanto surgem na leitura seguinte.

added
object[]
obrigatório

Transações a adicionar. Numa primeira leitura (sem cursor, ou após reset) são todas as transações que a conexão tinha quando a leitura começou, cada uma exatamente uma vez e no estado atual, mesmo que uma sincronização esteja a decorrer enquanto pagina. Nas leituras seguintes contém as transações novas desde o seu cursor, e a transação lançada que substitui uma pendente.

modified
object[]
obrigatório

Transações que mudaram desde o seu cursor, no estado atual. Aplique cada uma como upsert por id: uma transação que já recebeu ao paginar a primeira leitura volta a aparecer aqui se tiver mudado entretanto, e uma correção do banco também chega aqui.

removed
object[]
obrigatório

Transações que deixaram de existir, com um reason. Ignore um id que não tem: uma transação removida enquanto paginava uma primeira leitura foi entregue uma vez como added e chega na leitura seguinte.

has_more
boolean
obrigatório

true enquanto existirem mais páginas. Guarde next_cursor apenas depois de uma resposta com has_more: false; se a paginação falhar a meio, recomece a partir do cursor que tinha guardado.

next_page_token
string | null
obrigatório

Continua esta leitura enquanto has_more for true.

next_cursor
string | null
obrigatório

O ponto de controlo durável do feed, devolvido apenas na última página. Opaco e vinculado à aplicação, ao ambiente e à ligação. Pode ser reproduzido durante 90 dias. Numa primeira leitura, marca o momento em que a leitura começou, pelo que as alterações ocorridas entretanto chegam na leitura seguinte.

reset
boolean
obrigatório

true em cada bootstrap, ou seja, em cada leitura a partir de um cursor vazio: substitua a sua cópia pelo resultado, em vez de lhe acrescentar dados.

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