重新投递 Webhook 的 API

curl

curl -X POST 'https://verification.didit.me/v3/webhook/destinations/11111111-2222-3333-4444-555555555555/deliveries/66666666-7777-8888-9999-000000000001/resend/' \
  -H 'x-api-key: YOUR_API_KEY'

from didit import Didit

# Reads DIDIT_API_KEY.
client = Didit()

result = client.webhooks.destinations.resend_delivery(
    "11111111-2222-3333-4444-555555555555",
    "66666666-7777-8888-9999-000000000001",
)
print(result)

import Didit from "@didit-protocol/sdk-node";

// Reads DIDIT_API_KEY.
const didit = new Didit();

const result = await didit.webhooks.destinations.resendDelivery(
  "11111111-2222-3333-4444-555555555555",
  "66666666-7777-8888-9999-000000000001",
);
console.log(result);

ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()

result, err := client.Webhooks.Destinations.ResendDelivery(ctx, "11111111-2222-3333-4444-555555555555", "66666666-7777-8888-9999-000000000001")
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().resendDelivery("11111111-2222-3333-4444-555555555555", "66666666-7777-8888-9999-000000000001");
System.out.println(result);

<?php

require 'vendor/autoload.php';

use Didit\DiditClient;

// Reads DIDIT_API_KEY.
$didit = new DiditClient();

$result = $didit->webhooks->destinations->resendDelivery('11111111-2222-3333-4444-555555555555', '66666666-7777-8888-9999-000000000001');
print_r($result->toArray());

require "didit"

# Reads DIDIT_API_KEY.
didit = Didit::Client.new

result = didit.webhooks.destinations.resend_delivery(
  "11111111-2222-3333-4444-555555555555",
  "66666666-7777-8888-9999-000000000001"
)
puts result.to_h

using System;
using System.Text.Json;
using Didit;

// Reads DIDIT_API_KEY.
using var client = new DiditClient();

var result = await client.Webhooks.Destinations.ResendDeliveryAsync("11111111-2222-3333-4444-555555555555", "66666666-7777-8888-9999-000000000001");
Console.WriteLine(JsonSerializer.Serialize(result));

{
  "uuid": "66666666-7777-8888-9999-000000000004",
  "session_id": "22222222-3333-4444-5555-666666666666",
  "request_url": "https://yourapp.com/webhooks/didit",
  "response_status": 200,
  "response_time_ms": 151,
  "status": "In Progress",
  "webhook_type": "status.updated",
  "created_at": "2026-10-16T14:05:42.330981Z",
  "request_header": "{\"Content-Type\": \"application/json\", \"X-Signature\": \"b8eb1e376517ee0cad8ba98ff7f8fd35fc72eca231000963a96a335f82328835\", \"X-Signature-V2\": \"9efd2ce9ed1303e1d05273ef9608a59363ed9789a05253db4748b3e8e50cb109\", \"X-Signature-Simple\": \"bf3a9dc04b2c20ab539203b0cd5cca2a10f630bf62d8feb6d68d82af80f64774\", \"X-Timestamp\": \"1792159542\", \"User-Agent\": \"DiditWebhook/2.0 +https://didit.me\"}",
  "request_body": "{\"application_id\":\"aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee\",\"created_at\":1792056057,\"environment\":\"live\",\"event_id\":\"33333333-4444-5555-6666-777777777777\",\"sandbox_scenario\":null,\"session_id\":\"22222222-3333-4444-5555-666666666666\",\"status\":\"In Progress\",\"timestamp\":1792159542,\"vendor_data\":\"user-123\",\"webhook_type\":\"status.updated\",\"workflow_id\":\"44444444-5555-6666-7777-888888888888\",\"workflow_version\":3}"
}

POST

webhook

destinations

{destination_uuid}

deliveries

{delivery_uuid}

resend

curl

curl -X POST 'https://verification.didit.me/v3/webhook/destinations/11111111-2222-3333-4444-555555555555/deliveries/66666666-7777-8888-9999-000000000001/resend/' \
  -H 'x-api-key: YOUR_API_KEY'

from didit import Didit

# Reads DIDIT_API_KEY.
client = Didit()

result = client.webhooks.destinations.resend_delivery(
    "11111111-2222-3333-4444-555555555555",
    "66666666-7777-8888-9999-000000000001",
)
print(result)

import Didit from "@didit-protocol/sdk-node";

// Reads DIDIT_API_KEY.
const didit = new Didit();

const result = await didit.webhooks.destinations.resendDelivery(
  "11111111-2222-3333-4444-555555555555",
  "66666666-7777-8888-9999-000000000001",
);
console.log(result);

ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()

result, err := client.Webhooks.Destinations.ResendDelivery(ctx, "11111111-2222-3333-4444-555555555555", "66666666-7777-8888-9999-000000000001")
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().resendDelivery("11111111-2222-3333-4444-555555555555", "66666666-7777-8888-9999-000000000001");
System.out.println(result);

<?php

require 'vendor/autoload.php';

use Didit\DiditClient;

// Reads DIDIT_API_KEY.
$didit = new DiditClient();

$result = $didit->webhooks->destinations->resendDelivery('11111111-2222-3333-4444-555555555555', '66666666-7777-8888-9999-000000000001');
print_r($result->toArray());

require "didit"

# Reads DIDIT_API_KEY.
didit = Didit::Client.new

result = didit.webhooks.destinations.resend_delivery(
  "11111111-2222-3333-4444-555555555555",
  "66666666-7777-8888-9999-000000000001"
)
puts result.to_h

using System;
using System.Text.Json;
using Didit;

// Reads DIDIT_API_KEY.
using var client = new DiditClient();

var result = await client.Webhooks.Destinations.ResendDeliveryAsync("11111111-2222-3333-4444-555555555555", "66666666-7777-8888-9999-000000000001");
Console.WriteLine(JsonSerializer.Serialize(result));

{
  "uuid": "66666666-7777-8888-9999-000000000004",
  "session_id": "22222222-3333-4444-5555-666666666666",
  "request_url": "https://yourapp.com/webhooks/didit",
  "response_status": 200,
  "response_time_ms": 151,
  "status": "In Progress",
  "webhook_type": "status.updated",
  "created_at": "2026-10-16T14:05:42.330981Z",
  "request_header": "{\"Content-Type\": \"application/json\", \"X-Signature\": \"b8eb1e376517ee0cad8ba98ff7f8fd35fc72eca231000963a96a335f82328835\", \"X-Signature-V2\": \"9efd2ce9ed1303e1d05273ef9608a59363ed9789a05253db4748b3e8e50cb109\", \"X-Signature-Simple\": \"bf3a9dc04b2c20ab539203b0cd5cca2a10f630bf62d8feb6d68d82af80f64774\", \"X-Timestamp\": \"1792159542\", \"User-Agent\": \"DiditWebhook/2.0 +https://didit.me\"}",
  "request_body": "{\"application_id\":\"aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee\",\"created_at\":1792056057,\"environment\":\"live\",\"event_id\":\"33333333-4444-5555-6666-777777777777\",\"sandbox_scenario\":null,\"session_id\":\"22222222-3333-4444-5555-666666666666\",\"status\":\"In Progress\",\"timestamp\":1792159542,\"vendor_data\":\"user-123\",\"webhook_type\":\"status.updated\",\"workflow_id\":\"44444444-5555-6666-7777-888888888888\",\"workflow_version\":3}"
}

每次调用都会重新投递该 Webhook。在批量重发之前，请先让您的端点基于 event_id 实现幂等，并且只重发 response_status 为 null、400 或更高的投递。

重发会发送到原始投递所使用的 URL。如果您已将目标迁移到新的 URL，旧的投递仍会指向原来的 URL。请使用列出 Webhook 目标投递查找需要重发的投递，签名验证相关内容请参阅 Webhook 指南。

授权

x-api-key

string

header

必填

您的应用 API 密钥，可在 Business Console 的“开发者 -> API 密钥”中获取。主密钥拥有完整访问权限。指定名称的密钥可设置作用域：针对每个资源设为无权限、只读或读写，限定于特定工作流或已通过的会话、限定于 IP 地址列表，以及设置到期日期。401 表示密钥错误、已撤销或已过期；403 表示未发送密钥、密钥无权访问该资源或操作，或请求来自其 IP 列表之外的地址；在会话路由上返回 404 表示该会话不在该密钥允许的工作流或状态范围内。没有媒体访问权限的密钥获取到的图片、视频和 PDF URL 将为 null；没有会话写入权限的密钥获取到的会话链接和 token 将为 null。请参阅 https://docs.didit.me/console/api-keys。

路径参数

destination_uuid

string<uuid>

必填

投递发送至的 Webhook 目标的 UUID。

delivery_uuid

string<uuid>

必填

要重新发送的投递的 UUID：由 GET /v3/webhook/destinations/{destination_uuid}/deliveries/ 返回的条目的 uuid。

响应

已尝试的新投递。response_status 为您的 endpoint 此次返回的状态（504 超时、503 连接失败）。原始投递保持不变。

向 Webhook 目标发送的一次投递尝试，包含 Didit 发送的确切请求头和请求体。

uuid

string<uuid>

必填

投递 ID，用于获取详情和重新发送调用。

session_id

string<uuid> | null

必填

该事件涉及的用户验证会话。对于企业会话、用户、企业、交易、Travel Rule 和工作流事件为 null。

request_url

string<uri> | null

必填

投递发送的目标 URL：生成事件时目标的 URL。

response_status

integer | null

必填

您的 endpoint 返回的 HTTP 状态码。在投递已排队且尚未尝试时为 null。未收到 HTTP 响应时，Didit 会记录自身的状态码：您的 endpoint 未在 5 秒内响应记录为 504，连接失败记录为 503，因 URL 不安全而被拒绝（例如私有或内部地址）记录为 400，其他任何请求错误记录为 404。400 或更高视为投递失败。

response_time_ms

integer | null

必填

尝试所花费的时间，以毫秒为单位。投递处于队列中时为 null。

必填范围: x >= 0

status

string | null

必填

事件生成时报告的状态：会话事件对应会话状态（例如 Approved 或 In Review），用户和企业事件对应个人或公司的状态，交易事件对应交易状态。对于不携带状态的事件为 null。

webhook_type

enum<string>

必填

支持的 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

created_at

string<date-time>

必填

投递创建的时间。

request_header

string

必填

Didit 发送的请求头的 JSON 文本（字符串）：Content-Type、X-Signature、X-Signature-V2、X-Signature-Simple、X-Timestamp 和 User-Agent。请使用 JSON 解析器进行解析。其中包含签名，绝不会包含签名密钥。

request_body

string

必填

Didit 发送的准确 payload 的 JSON 文本（字符串），键已排序，包括 event_id 和 timestamp。请使用 JSON 解析器进行解析；参见 Payload 结构。对于没有 media: read 权限的作用域密钥，其中的媒体 URL 为 null；没有 sessions: write 权限时，会话 token 和托管验证链接为 null。以此方式修改的请求体将不再与其签名匹配。Didit 不会记录您的 endpoint 返回的响应体。

最后修改于 2026年11月7日