Saltar para o conteúdo principal
GET
curl
A resposta inclui os mesmos campos de estado que a lista, além de um summary dos últimos 30 dias.

Relacionados

Autorizações

x-api-key
string
header
obrigatório

A chave de API da sua aplicação, a partir de Programadores -> Chaves de API na Business Console. A chave principal tem acesso total. Uma chave nomeada pode ter o âmbito definido: nenhum, leitura ou escrita por recurso, limitada a alguns fluxos ou a sessões aprovadas, a uma lista de endereços IP e a uma data de validade. 401 significa que a chave está incorreta, revogada ou expirada; 403 significa que nenhuma chave foi enviada, 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 URLs de imagens, vídeos e PDFs como nulos, e uma chave sem permissão de escrita em sessões recebe ligações de sessão e tokens como nulos. Consulte https://docs.didit.me/console/api-keys.

Parâmetros de caminho

destination_uuid
string<uuid>
obrigatório

UUID do destino (o uuid retornado por criar / listar).

Resposta

Detalhes do destino do webhook.

uuid
string<uuid>
label
string
url
string<uri>
enabled
boolean
webhook_version
enum<string>
Opções disponíveis:
v1,
v2,
v3
secret_shared_key
string

Segredo de assinatura HMAC (token seguro para URL de 43 carateres). Devolvido sempre na totalidade para chamadas com chave de API; os utilizadores da Consola necessitam de read:webhooks, caso contrário recebem uma string vazia.

secret_last4
string

Últimos quatro carateres do segredo de assinatura atual do destino, para que possa distinguir os segredos. Não são suficientes para verificar uma assinatura.

previous_secret_expires_at
string<date-time> | null

Definido durante 24 horas após o segredo de assinatura do destino ser alterado na Business Console. Até esse momento, cada entrega para o destino também inclui X-Signature-Previous, X-Signature-V2-Previous e X-Signature-Simple-Previous, gerados com o segredo substituído (consulte Verificação da assinatura). null quando não ocorreu qualquer rotação nas últimas 24 horas.

subscribed_events
enum<string>[]

Filtro de eventos para este destino do webhook. O Didit entrega apenas webhooks cujo tipo de evento corresponda exatamente a um destes valores — não existe subscrição com carateres universais. Ao ser enviada, a lista deve conter pelo menos um evento válido (um [] explícito é rejeitado com 400); um destino cuja lista esteja vazia (campo omitido na criação) não recebe nada. Na atualização, a lista é substituída integralmente, nunca fundida.

Minimum array length: 1

Nome de evento de webhook suportado. Utilize estas strings exatas em subscribed_events; valores não suportados são rejeitados.

Opções disponíveis:
status.updated,
data.updated,
user.status.updated,
user.data.updated,
business.status.updated,
business.data.updated,
activity.created,
transaction.created,
transaction.status.updated,
travel_rule.status.updated,
workflow.compliance_changed,
transaction_rule_suggestions.created,
auth.signup,
auth.login,
auth.login_failed,
auth.password_reset_requested,
auth.password_reset_completed,
auth.mfa_changed,
auth.new_device,
auth.account_locked,
investigator.report.ready,
investigator.decision.automated,
investigator.decision.overridden,
investigator.decision.contested,
investigator.question.raised,
investigator.automation.paused,
investigator.rfi.answered,
investigator.rfi.overdue,
investigator.drift.detected,
investigator.sla.breached,
investigator.qa.failed,
investigator.external.report.ready
Exemplo:
created_by_email
string | null

E-mail do membro da Business Console que criou o destino. null para um destino criado com uma chave de API.

created_by_name
string | null

Nome do membro da Business Console que criou o destino. null para um destino criado com uma chave de API.

created_at
string<date-time>
updated_at
string<date-time>
health_status
enum<string>

Estado da entrega. failing: 3 ou mais eventos consecutivos falharam a primeira tentativa de entrega desde que o destino respondeu com sucesso pela última vez (consulte failing_streak). degraded: não está a falhar, mas uma tentativa de entrega falhou nas últimas 24 horas e nenhuma tentativa posterior entregou esse evento; uma nova tentativa ou reenvio bem-sucedido limpa este estado. healthy: nenhum dos anteriores. Independente de enabled. Uma tentativa falhada é aquela respondida com HTTP 400 ou superior, ou que não obteve qualquer resposta.

Opções disponíveis:
healthy,
degraded,
failing
failing_streak
integer

Quantos eventos consecutivos falharam a primeira tentativa de entrega desde a última resposta bem-sucedida do destino, nos últimos 30 dias. As novas tentativas não são contabilizadas, e qualquer tentativa bem-sucedida, incluindo uma nova tentativa ou um reenvio, termina a sequência. 0 quando nenhum evento falhou desde o último sucesso.

failing_since
string<date-time> | null

Quando foi feita a primeira tentativa falhada da atual failing_streak. null quando failing_streak é 0.

last_success_at
string<date-time> | null

Quando o destino respondeu pela última vez a uma entrega com um estado HTTP inferior a 400, nos últimos 30 dias. null se não o tiver feito nesse período.

environment
enum<string>

Ambiente da aplicação a que pertence o destino.

Opções disponíveis:
live,
sandbox
summary
object

Métricas de entrega para os últimos metrics_window_days (30) dias. last_delivery_at é a tentativa mais recente, independentemente de quando foi efetuada.

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