Primeiros passos
Integração / SDKs
Verificação de usuários
Verificação de empresas
Monitoramento de transações
Registro de alteraçõescurl -X GET 'https://verification.didit.me/v3/webhook/destinations/' \
-H 'x-api-key: YOUR_API_KEY'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.webhooks.destinations.list()
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.webhooks.destinations.list();
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.Webhooks.Destinations.List(ctx)
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import me.didit.Didit;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.webhooks().destinations().list();
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->webhooks->destinations->list();
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
didit.webhooks.destinations.list.each do |item|
puts item.to_h
endusing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.Webhooks.Destinations.ListAsync();
Console.WriteLine(JsonSerializer.Serialize(result));[
{
"uuid": "11111111-2222-3333-4444-555555555555",
"label": "Production session webhooks",
"url": "https://yourapp.com/webhooks/didit",
"enabled": true,
"webhook_version": "v3",
"subscribed_events": [
"status.updated",
"data.updated"
],
"subscribed_events_count": 2,
"deliveries_count": 12453,
"failed_deliveries_count": 14,
"average_response_time_ms": 187,
"error_rate_percentage": 0,
"last_delivery_at": "2026-05-17T09:21:18Z",
"metrics_window_days": 30,
"health_status": "healthy",
"failing_streak": 0,
"failing_since": null,
"last_success_at": "2026-05-17T09:21:18Z",
"environment": "live",
"daily_points": [
{
"date": "2026-04-18",
"total_deliveries": 415,
"failed_deliveries": 0
},
{
"date": "2026-04-19",
"total_deliveries": 415,
"failed_deliveries": 0
},
{
"date": "2026-04-20",
"total_deliveries": 415,
"failed_deliveries": 0
},
{
"date": "2026-04-21",
"total_deliveries": 415,
"failed_deliveries": 0
},
{
"date": "2026-04-22",
"total_deliveries": 415,
"failed_deliveries": 0
},
{
"date": "2026-04-23",
"total_deliveries": 415,
"failed_deliveries": 0
},
{
"date": "2026-04-24",
"total_deliveries": 415,
"failed_deliveries": 9
},
{
"date": "2026-04-25",
"total_deliveries": 415,
"failed_deliveries": 0
},
{
"date": "2026-04-26",
"total_deliveries": 415,
"failed_deliveries": 0
},
{
"date": "2026-04-27",
"total_deliveries": 415,
"failed_deliveries": 0
},
{
"date": "2026-04-28",
"total_deliveries": 415,
"failed_deliveries": 0
},
{
"date": "2026-04-29",
"total_deliveries": 415,
"failed_deliveries": 0
},
{
"date": "2026-04-30",
"total_deliveries": 415,
"failed_deliveries": 0
},
{
"date": "2026-05-01",
"total_deliveries": 415,
"failed_deliveries": 0
},
{
"date": "2026-05-02",
"total_deliveries": 415,
"failed_deliveries": 0
},
{
"date": "2026-05-03",
"total_deliveries": 415,
"failed_deliveries": 0
},
{
"date": "2026-05-04",
"total_deliveries": 415,
"failed_deliveries": 0
},
{
"date": "2026-05-05",
"total_deliveries": 415,
"failed_deliveries": 0
},
{
"date": "2026-05-06",
"total_deliveries": 415,
"failed_deliveries": 0
},
{
"date": "2026-05-07",
"total_deliveries": 415,
"failed_deliveries": 0
},
{
"date": "2026-05-08",
"total_deliveries": 415,
"failed_deliveries": 0
},
{
"date": "2026-05-09",
"total_deliveries": 415,
"failed_deliveries": 5
},
{
"date": "2026-05-10",
"total_deliveries": 415,
"failed_deliveries": 0
},
{
"date": "2026-05-11",
"total_deliveries": 415,
"failed_deliveries": 0
},
{
"date": "2026-05-12",
"total_deliveries": 415,
"failed_deliveries": 0
},
{
"date": "2026-05-13",
"total_deliveries": 415,
"failed_deliveries": 0
},
{
"date": "2026-05-14",
"total_deliveries": 415,
"failed_deliveries": 0
},
{
"date": "2026-05-15",
"total_deliveries": 416,
"failed_deliveries": 0
},
{
"date": "2026-05-16",
"total_deliveries": 416,
"failed_deliveries": 0
},
{
"date": "2026-05-17",
"total_deliveries": 416,
"failed_deliveries": 0
}
],
"secret_last4": "0xnQ",
"created_by_email": null,
"created_by_name": null,
"created_at": "2026-01-04T08:00:00Z",
"updated_at": "2026-04-22T14:09:11Z"
},
{
"uuid": "22222222-3333-4444-5555-666666666666",
"label": "Staging mirror",
"url": "https://staging.yourapp.com/webhooks/didit",
"enabled": false,
"webhook_version": "v3",
"subscribed_events": [
"status.updated"
],
"subscribed_events_count": 1,
"deliveries_count": 0,
"failed_deliveries_count": 0,
"average_response_time_ms": null,
"error_rate_percentage": 0,
"last_delivery_at": null,
"metrics_window_days": 30,
"health_status": "healthy",
"failing_streak": 0,
"failing_since": null,
"last_success_at": null,
"environment": "live",
"daily_points": [
{
"date": "2026-04-18",
"total_deliveries": 0,
"failed_deliveries": 0
},
{
"date": "2026-04-19",
"total_deliveries": 0,
"failed_deliveries": 0
},
{
"date": "2026-04-20",
"total_deliveries": 0,
"failed_deliveries": 0
},
{
"date": "2026-04-21",
"total_deliveries": 0,
"failed_deliveries": 0
},
{
"date": "2026-04-22",
"total_deliveries": 0,
"failed_deliveries": 0
},
{
"date": "2026-04-23",
"total_deliveries": 0,
"failed_deliveries": 0
},
{
"date": "2026-04-24",
"total_deliveries": 0,
"failed_deliveries": 0
},
{
"date": "2026-04-25",
"total_deliveries": 0,
"failed_deliveries": 0
},
{
"date": "2026-04-26",
"total_deliveries": 0,
"failed_deliveries": 0
},
{
"date": "2026-04-27",
"total_deliveries": 0,
"failed_deliveries": 0
},
{
"date": "2026-04-28",
"total_deliveries": 0,
"failed_deliveries": 0
},
{
"date": "2026-04-29",
"total_deliveries": 0,
"failed_deliveries": 0
},
{
"date": "2026-04-30",
"total_deliveries": 0,
"failed_deliveries": 0
},
{
"date": "2026-05-01",
"total_deliveries": 0,
"failed_deliveries": 0
},
{
"date": "2026-05-02",
"total_deliveries": 0,
"failed_deliveries": 0
},
{
"date": "2026-05-03",
"total_deliveries": 0,
"failed_deliveries": 0
},
{
"date": "2026-05-04",
"total_deliveries": 0,
"failed_deliveries": 0
},
{
"date": "2026-05-05",
"total_deliveries": 0,
"failed_deliveries": 0
},
{
"date": "2026-05-06",
"total_deliveries": 0,
"failed_deliveries": 0
},
{
"date": "2026-05-07",
"total_deliveries": 0,
"failed_deliveries": 0
},
{
"date": "2026-05-08",
"total_deliveries": 0,
"failed_deliveries": 0
},
{
"date": "2026-05-09",
"total_deliveries": 0,
"failed_deliveries": 0
},
{
"date": "2026-05-10",
"total_deliveries": 0,
"failed_deliveries": 0
},
{
"date": "2026-05-11",
"total_deliveries": 0,
"failed_deliveries": 0
},
{
"date": "2026-05-12",
"total_deliveries": 0,
"failed_deliveries": 0
},
{
"date": "2026-05-13",
"total_deliveries": 0,
"failed_deliveries": 0
},
{
"date": "2026-05-14",
"total_deliveries": 0,
"failed_deliveries": 0
},
{
"date": "2026-05-15",
"total_deliveries": 0,
"failed_deliveries": 0
},
{
"date": "2026-05-16",
"total_deliveries": 0,
"failed_deliveries": 0
},
{
"date": "2026-05-17",
"total_deliveries": 0,
"failed_deliveries": 0
}
],
"secret_last4": "k9Qe",
"created_by_email": "reviewer@example.com",
"created_by_name": "Example Reviewer",
"created_at": "2026-03-12T10:15:02Z",
"updated_at": "2026-03-12T10:15:02Z"
}
]{
"detail": "You do not have permission to perform this action."
}{
"detail": "Request was throttled. Expected available in 30 seconds."
}Listar destinos de webhook pela API
Liste todos os destinos de webhook da Didit com versão, eventos assinados, métricas de entrega de 30 dias e status de saúde. Pague por chamada.
curl -X GET 'https://verification.didit.me/v3/webhook/destinations/' \
-H 'x-api-key: YOUR_API_KEY'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.webhooks.destinations.list()
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.webhooks.destinations.list();
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.Webhooks.Destinations.List(ctx)
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import me.didit.Didit;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.webhooks().destinations().list();
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->webhooks->destinations->list();
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
didit.webhooks.destinations.list.each do |item|
puts item.to_h
endusing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.Webhooks.Destinations.ListAsync();
Console.WriteLine(JsonSerializer.Serialize(result));[
{
"uuid": "11111111-2222-3333-4444-555555555555",
"label": "Production session webhooks",
"url": "https://yourapp.com/webhooks/didit",
"enabled": true,
"webhook_version": "v3",
"subscribed_events": [
"status.updated",
"data.updated"
],
"subscribed_events_count": 2,
"deliveries_count": 12453,
"failed_deliveries_count": 14,
"average_response_time_ms": 187,
"error_rate_percentage": 0,
"last_delivery_at": "2026-05-17T09:21:18Z",
"metrics_window_days": 30,
"health_status": "healthy",
"failing_streak": 0,
"failing_since": null,
"last_success_at": "2026-05-17T09:21:18Z",
"environment": "live",
"daily_points": [
{
"date": "2026-04-18",
"total_deliveries": 415,
"failed_deliveries": 0
},
{
"date": "2026-04-19",
"total_deliveries": 415,
"failed_deliveries": 0
},
{
"date": "2026-04-20",
"total_deliveries": 415,
"failed_deliveries": 0
},
{
"date": "2026-04-21",
"total_deliveries": 415,
"failed_deliveries": 0
},
{
"date": "2026-04-22",
"total_deliveries": 415,
"failed_deliveries": 0
},
{
"date": "2026-04-23",
"total_deliveries": 415,
"failed_deliveries": 0
},
{
"date": "2026-04-24",
"total_deliveries": 415,
"failed_deliveries": 9
},
{
"date": "2026-04-25",
"total_deliveries": 415,
"failed_deliveries": 0
},
{
"date": "2026-04-26",
"total_deliveries": 415,
"failed_deliveries": 0
},
{
"date": "2026-04-27",
"total_deliveries": 415,
"failed_deliveries": 0
},
{
"date": "2026-04-28",
"total_deliveries": 415,
"failed_deliveries": 0
},
{
"date": "2026-04-29",
"total_deliveries": 415,
"failed_deliveries": 0
},
{
"date": "2026-04-30",
"total_deliveries": 415,
"failed_deliveries": 0
},
{
"date": "2026-05-01",
"total_deliveries": 415,
"failed_deliveries": 0
},
{
"date": "2026-05-02",
"total_deliveries": 415,
"failed_deliveries": 0
},
{
"date": "2026-05-03",
"total_deliveries": 415,
"failed_deliveries": 0
},
{
"date": "2026-05-04",
"total_deliveries": 415,
"failed_deliveries": 0
},
{
"date": "2026-05-05",
"total_deliveries": 415,
"failed_deliveries": 0
},
{
"date": "2026-05-06",
"total_deliveries": 415,
"failed_deliveries": 0
},
{
"date": "2026-05-07",
"total_deliveries": 415,
"failed_deliveries": 0
},
{
"date": "2026-05-08",
"total_deliveries": 415,
"failed_deliveries": 0
},
{
"date": "2026-05-09",
"total_deliveries": 415,
"failed_deliveries": 5
},
{
"date": "2026-05-10",
"total_deliveries": 415,
"failed_deliveries": 0
},
{
"date": "2026-05-11",
"total_deliveries": 415,
"failed_deliveries": 0
},
{
"date": "2026-05-12",
"total_deliveries": 415,
"failed_deliveries": 0
},
{
"date": "2026-05-13",
"total_deliveries": 415,
"failed_deliveries": 0
},
{
"date": "2026-05-14",
"total_deliveries": 415,
"failed_deliveries": 0
},
{
"date": "2026-05-15",
"total_deliveries": 416,
"failed_deliveries": 0
},
{
"date": "2026-05-16",
"total_deliveries": 416,
"failed_deliveries": 0
},
{
"date": "2026-05-17",
"total_deliveries": 416,
"failed_deliveries": 0
}
],
"secret_last4": "0xnQ",
"created_by_email": null,
"created_by_name": null,
"created_at": "2026-01-04T08:00:00Z",
"updated_at": "2026-04-22T14:09:11Z"
},
{
"uuid": "22222222-3333-4444-5555-666666666666",
"label": "Staging mirror",
"url": "https://staging.yourapp.com/webhooks/didit",
"enabled": false,
"webhook_version": "v3",
"subscribed_events": [
"status.updated"
],
"subscribed_events_count": 1,
"deliveries_count": 0,
"failed_deliveries_count": 0,
"average_response_time_ms": null,
"error_rate_percentage": 0,
"last_delivery_at": null,
"metrics_window_days": 30,
"health_status": "healthy",
"failing_streak": 0,
"failing_since": null,
"last_success_at": null,
"environment": "live",
"daily_points": [
{
"date": "2026-04-18",
"total_deliveries": 0,
"failed_deliveries": 0
},
{
"date": "2026-04-19",
"total_deliveries": 0,
"failed_deliveries": 0
},
{
"date": "2026-04-20",
"total_deliveries": 0,
"failed_deliveries": 0
},
{
"date": "2026-04-21",
"total_deliveries": 0,
"failed_deliveries": 0
},
{
"date": "2026-04-22",
"total_deliveries": 0,
"failed_deliveries": 0
},
{
"date": "2026-04-23",
"total_deliveries": 0,
"failed_deliveries": 0
},
{
"date": "2026-04-24",
"total_deliveries": 0,
"failed_deliveries": 0
},
{
"date": "2026-04-25",
"total_deliveries": 0,
"failed_deliveries": 0
},
{
"date": "2026-04-26",
"total_deliveries": 0,
"failed_deliveries": 0
},
{
"date": "2026-04-27",
"total_deliveries": 0,
"failed_deliveries": 0
},
{
"date": "2026-04-28",
"total_deliveries": 0,
"failed_deliveries": 0
},
{
"date": "2026-04-29",
"total_deliveries": 0,
"failed_deliveries": 0
},
{
"date": "2026-04-30",
"total_deliveries": 0,
"failed_deliveries": 0
},
{
"date": "2026-05-01",
"total_deliveries": 0,
"failed_deliveries": 0
},
{
"date": "2026-05-02",
"total_deliveries": 0,
"failed_deliveries": 0
},
{
"date": "2026-05-03",
"total_deliveries": 0,
"failed_deliveries": 0
},
{
"date": "2026-05-04",
"total_deliveries": 0,
"failed_deliveries": 0
},
{
"date": "2026-05-05",
"total_deliveries": 0,
"failed_deliveries": 0
},
{
"date": "2026-05-06",
"total_deliveries": 0,
"failed_deliveries": 0
},
{
"date": "2026-05-07",
"total_deliveries": 0,
"failed_deliveries": 0
},
{
"date": "2026-05-08",
"total_deliveries": 0,
"failed_deliveries": 0
},
{
"date": "2026-05-09",
"total_deliveries": 0,
"failed_deliveries": 0
},
{
"date": "2026-05-10",
"total_deliveries": 0,
"failed_deliveries": 0
},
{
"date": "2026-05-11",
"total_deliveries": 0,
"failed_deliveries": 0
},
{
"date": "2026-05-12",
"total_deliveries": 0,
"failed_deliveries": 0
},
{
"date": "2026-05-13",
"total_deliveries": 0,
"failed_deliveries": 0
},
{
"date": "2026-05-14",
"total_deliveries": 0,
"failed_deliveries": 0
},
{
"date": "2026-05-15",
"total_deliveries": 0,
"failed_deliveries": 0
},
{
"date": "2026-05-16",
"total_deliveries": 0,
"failed_deliveries": 0
},
{
"date": "2026-05-17",
"total_deliveries": 0,
"failed_deliveries": 0
}
],
"secret_last4": "k9Qe",
"created_by_email": "reviewer@example.com",
"created_by_name": "Example Reviewer",
"created_at": "2026-03-12T10:15:02Z",
"updated_at": "2026-03-12T10:15:02Z"
}
]{
"detail": "You do not have permission to perform this action."
}{
"detail": "Request was throttled. Expected available in 30 seconds."
}Status do destino
health_status resume como um destino tem respondido às suas entregas.
| Valor | Significado |
|---|---|
failing | 3 ou mais eventos consecutivos falharam na primeira tentativa de entrega desde a última vez que o destino respondeu com sucesso. failing_streak contabiliza esses eventos e failing_since indica quando o primeiro deles falhou. |
degraded | Não está falhando, mas uma tentativa de entrega falhou nas últimas 24 horas e nenhuma tentativa posterior entregou esse evento. Uma nova tentativa ou um reenvio que o entregue remove esse status. |
healthy | Nenhuma das situações acima. |
failing_streak, e qualquer tentativa bem-sucedida, incluindo uma nova tentativa ou um reenvio, encerra a sequência.
health_status é independente de enabled.
As métricas de entrega e daily_points abrangem os últimos 30 dias (metrics_window_days).
daily_points sempre tem 30 entradas, uma por dia UTC, da mais antiga para a mais recente.
Relacionados
- Obter destino de webhook: leia um destino com seu segredo de assinatura e o resumo de entregas.
- Guia de webhooks: verificação de assinatura, novas tentativas e payloads.
Autorizações
Chave de API da sua aplicação, em Developers -> API keys no Business Console. A chave principal tem acesso total. Uma chave nomeada pode ter escopo restrito: nenhum acesso, 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á errada, 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 a requisição veio de um endereço fora da sua lista de IPs; 404 em uma rota de sessão significa que a sessão está fora dos fluxos ou status da chave. Uma chave sem acesso a mídia recebe URLs de imagem, vídeo e PDF como null, e uma chave sem permissão de escrita em sessões recebe links e tokens de sessão como null. Consulte https://docs.didit.me/console/api-keys.
Resposta
Lista de destinos de webhook (sem paginação, os mais antigos primeiro).
Identificador estável do destino; use como {destination_uuid} para atualizar ou excluir.
Nome legível exibido no Console.
URL de destino que recebe requisições POST com o payload do webhook.
Quando false, a Didit ignora silenciosamente a entrega para este destino.
Versão do esquema de payload enviada a este destino. v3 é o formato atual/recomendado.
v1, v2, v3 Filtro de eventos deste destino do webhook. A Didit entrega apenas webhooks cujo tipo de evento corresponde exatamente a um destes valores; não existe assinatura curinga. Quando enviada, a lista deve conter pelo menos um evento válido (um [] explícito é rejeitado com 400); um destino cuja lista está vazia (campo omitido na criação) não recebe nada. Na atualização, a lista é substituída por inteiro, nunca mesclada.
1Nome de evento de webhook compatível. Use exatamente estas strings em subscribed_events; valores não compatíveis são rejeitados.
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 ["status.updated", "data.updated"]
Tamanho de subscribed_events armazenado em cache, útil para renderizar a interface.
Tentativas de entrega (incluindo novas tentativas) feitas para este destino nos últimos 30 dias.
Tentativas de entrega nos últimos 30 dias às quais o destino respondeu com HTTP 400 ou superior, ou não respondeu (tempo esgotado, conexão recusada ou endereço bloqueado).
Tempo médio de resposta em milissegundos nos últimos 30 dias, arredondado para um número inteiro. null quando não houve entregas nesse período.
round(failed_deliveries_count / deliveries_count * 100) nos últimos 30 dias; 0 quando não há entregas.
Data e hora da tentativa de entrega mais recente (com sucesso ou falha). null se nunca foi entregue.
Duração, em dias, da janela coberta por deliveries_count, failed_deliveries_count, average_response_time_ms, error_rate_percentage e daily_points. Sempre 30.
Saúde das entregas. failing: 3 ou mais eventos consecutivos falharam na primeira tentativa de entrega desde a última vez que o destino respondeu com sucesso (consulte failing_streak). degraded: não está em falha, mas uma tentativa de entrega falhou nas últimas 24 horas e nenhuma tentativa posterior entregou esse evento; uma nova tentativa ou um reenvio que o entregue remove esse estado. healthy: nenhum dos dois. Independe de enabled. Uma tentativa com falha é aquela respondida com HTTP 400 ou superior, ou que não recebeu resposta.
healthy, degraded, failing Quantos eventos consecutivos falharam na primeira tentativa de entrega desde a última resposta bem-sucedida do destino, nos últimos 30 dias. Novas tentativas não são contadas, e qualquer tentativa bem-sucedida, incluindo uma nova tentativa ou um reenvio, encerra a sequência. 0 quando nenhum evento falhou desde o último sucesso.
Quando foi feita a primeira tentativa com falha do failing_streak atual. null quando failing_streak é 0.
Quando o destino respondeu pela última vez a uma entrega com um status HTTP abaixo de 400, nos últimos 30 dias. null se isso não ocorreu nesse período.
Ambiente da aplicação proprietária do destino.
live, sandbox Uma entrada por dia UTC dos últimos 30 dias, da mais antiga para a mais recente, incluindo dias sem entregas. Conta todas as tentativas, incluindo as novas tentativas.
Show child attributes
Show child attributes
Últimos quatro caracteres do segredo de assinatura atual do destino, para que você possa distinguir os segredos. Não é suficiente para verificar uma assinatura.
E-mail do membro do Business Console que criou o destino. null para um destino criado com uma chave de API.
Nome do membro do Business Console que criou o destino. null para um destino criado com uma chave de API.