Saltar para o conteúdo principal
DELETE
curl
O endpoint Eliminar uma ligação bancária da Didit interrompe o acesso ao banco e elimina as contas, os saldos e as transações armazenados da ligação. A eliminação é irreversível. Para interromper o acesso sem eliminar, use revogar. Consulte Dados, consentimento e eliminação para saber o que é e o que não é afetado.

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.

Cabeçalhos

Idempotency-Key
string

Chave opcional, à sua escolha, para garantir a segurança de novas tentativas numa operação, com até 255 caracteres (um UUID funciona). Um pedido repetido com a mesma chave, endpoint, parâmetros de query e corpo recebe a primeira resposta, com o mesmo código de estado e o mesmo corpo, e não é executado nem faturado uma segunda vez. A mesma chave com outro endpoint, outros parâmetros de query ou outro corpo devolve 409 idempotency_key_reused. Enquanto o primeiro pedido ainda estiver em execução, devolve 409 idempotency_key_in_progress com Retry-After. Um pedido falhado (qualquer 4xx ou 5xx) não é guardado, pelo que pode ser enviado novamente com a mesma chave. As chaves pertencem à sua aplicação, quer chame a API com uma chave de API, quer com um token de acesso. Consulte Novas tentativas e idempotência.

Required string length: 1 - 255

Parâmetros de caminho

id
string<uuid>
obrigatório

O id da ligação.

Resposta

Eliminação aceite.

Eliminação aceite. Os dados bancários da ligação estão a ser eliminados e as suas operações de dados respondem com 409 connection_not_active; ler a ligação devolve um registo mínimo com este estado erasure.

id
string<uuid>
obrigatório

O id da ligação.

erasure
object
obrigatório

Progresso de uma eliminação que pediu.

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