Начало работы
Интеграция / SDK
Проверка пользователей
Верификация бизнеса
Мониторинг транзакций
Журнал изменений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."
}Список адресов назначения webhook через API
Получите все адреса назначения webhook в Didit с версией webhook, подписанными событиями, метриками доставки за 30 дней и статусом состояния. Оплата за вызов.
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."
}Состояние адреса назначения
health_status показывает, как адрес назначения отвечал на доставку событий.
| Значение | Что означает |
|---|---|
failing | 3 или более последовательных событий не были доставлены с первой попытки с момента последнего успешного ответа адреса назначения. failing_streak считает их, а failing_since указывает время первой неудачной попытки. |
degraded | Адрес не в состоянии сбоя, но за последние 24 часа одна из попыток доставки завершилась ошибкой, и ни одна последующая попытка не доставила это событие. Повторная попытка или повторная отправка, которая доставит событие, снимает этот статус. |
healthy | Ни одно из перечисленного выше. |
failing_streak, а любая успешная попытка, включая повторную попытку или повторную отправку, завершает серию.
health_status не зависит от enabled.
Метрики доставки и daily_points охватывают последние 30 дней (metrics_window_days).
daily_points всегда содержит 30 записей, по одной на каждый день UTC, от самой старой к самой новой.
Связанные материалы
- Получить адрес назначения webhook: просмотр одного адреса назначения с секретом подписи и сводкой доставки.
- Руководство по webhook: проверка подписи, повторные попытки и payload.
Авторизации
API-ключ вашего приложения из раздела «Разработчикам» -> «API-ключи» в Business Console. Основной ключ имеет полный доступ. Именованный ключ может иметь ограниченную область действия: без доступа, чтение или запись для каждого ресурса, ограничение определенными сценариями или одобренными сессиями, списком IP-адресов и сроком действия. 401 означает, что ключ неверен, отозван или его срок действия истек; 403 означает, что ключ не был передан, у ключа нет доступа к этому ресурсу или действию, либо запрос поступил с адреса вне его списка IP-адресов; 404 на маршруте сессии означает, что сессия не входит в сценарии или статусы ключа. Ключ без доступа к медиа получает URL изображений, видео и PDF как null, а ключ без прав на запись сессий получает ссылки на сессии и токены как null. См. https://docs.didit.me/console/api-keys.
Ответ
Список адресов назначения webhook (без пагинации, сначала самые старые).
Постоянный идентификатор назначения; используйте как {destination_uuid} для обновления или удаления.
Понятное имя, отображаемое в Console.
URL адреса назначения, принимающий POST-запросы с payload webhook.
Если false, Didit без уведомления пропускает доставку на этот адрес назначения.
Версия схемы payload, отправляемая по этому адресу назначения. v3 является текущим и рекомендуемым форматом.
v1, v2, v3 Фильтр событий для этого адреса назначения webhook. Didit доставляет только те webhook, чей тип события точно совпадает с одним из этих значений — подписка по маске отсутствует. При отправке список должен содержать как минимум одно допустимое событие (явный пустой массив [] отклоняется с кодом 400); адрес назначения с пустым списком (поле пропущено при создании) ничего не получает. При обновлении список заменяется целиком, а не объединяется.
1Поддерживаемое имя события webhook. Используйте именно эти строки в subscribed_events; неподдерживаемые значения отклоняются.
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"]
Кэшированная длина subscribed_events, полезна для отрисовки в UI.
Попытки доставки (включая повторные попытки), выполненные на этот адрес назначения за последние 30 дней.
Попытки доставки за последние 30 дней, на которые адрес назначения ответил кодом HTTP 400 или выше либо не ответил (тайм-аут, отклонённое соединение или заблокированный адрес).
Среднее время ответа в миллисекундах за последние 30 дней, округлённое до целого числа. null, если за этот период доставок не было.
round(failed_deliveries_count / deliveries_count * 100) за последние 30 дней; 0, если доставок не было.
Временная метка последней попытки доставки (успешной или неудачной). null, если доставка не выполнялась.
Длина окна в днях, охватываемого полями deliveries_count, failed_deliveries_count, average_response_time_ms, error_rate_percentage и daily_points. Всегда 30.
Состояние доставки. failing: 3 или более последовательных событий завершились неудачей при первой попытке доставки с момента последнего успешного ответа адреса назначения (см. failing_streak). degraded: не failing, но за последние 24 часа произошла неудачная попытка доставки, и ни одна последующая попытка пока не доставила это событие; повторная попытка или повторная отправка, которая доставит его, сбрасывает этот статус. healthy: ни то, ни другое. Не зависит от enabled. Неудачной считается попытка, получившая ответ HTTP 400 или выше, либо оставшаяся вовсе без ответа.
healthy, degraded, failing Количество последовательных событий, первая попытка доставки которых завершилась неудачно с момента последнего успешного ответа адреса назначения за последние 30 дней. Повторные попытки не учитываются, и любая успешная попытка, включая повторную попытку или повторную отправку, прерывает серию. Значение равно 0, если с момента последнего успеха не было ни одного сбоя.
Когда была совершена первая неудачная попытка из текущей серии ошибок failing_streak. null, если failing_streak равен 0.
Когда адрес назначения в последний раз ответил на доставку с HTTP-статусом ниже 400 за последние 30 дней. null, если ответов в этот период не было.
Среда приложения, которому принадлежит адрес назначения.
live, sandbox Одна запись на каждый день по UTC за последние 30 дней, начиная с самых старых, включая дни без доставок. Учитывает каждую попытку, включая повторные попытки.
Show child attributes
Show child attributes
Последние четыре символа текущего секрета подписи адреса назначения, позволяющие различать секреты. Недостаточно для проверки подписи.
Электронная почта участника Business Console, создавшего адрес назначения. null для адреса назначения, созданного с помощью API-ключа.
Имя участника Business Console, создавшего адрес назначения. null для адреса назначения, созданного с помощью API-ключа.