跳转到主要内容
PATCH
curl
使用此 endpoint更改目标发送 Webhook 的地址以及目标接收的事件。

更新 subscribed_events

发送 subscribed_events 时,请提供更新后应保持订阅的完整事件列表。该数组会替换之前的订阅集合。
支持的值如下: 调查员(investigator.*)和认证(auth.*)事件系列也受支持;完整列表请参阅 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。

请求体

application/json
label
string

新的人类可读名称。

url
string<uri>

新目标 URL。在应用内必须唯一。

enabled
boolean

设为 false 可暂停向此目标的投递而无需将其删除。

webhook_version
enum<string>

用于未来投递的新 payload 模式版本。

可用选项:
v1,
v2,
v3
subscribed_events
enum<string>[]

此 Webhook 目标的事件过滤器。Didit 仅投递事件类型与这些值之一完全匹配的 Webhook,不支持通配符订阅。发送时,列表必须包含至少一个有效事件(显式传入 [] 将被拒绝并返回 400);列表为空的目标(创建时省略该字段)不会接收任何内容。更新时,列表会被整体替换,绝不会进行合并。

Minimum array length: 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
示例:

响应

已更新 Webhook 目标。响应体结构与 GET /v3/webhook/destinations/{destination_uuid}/ 相同。

uuid
string<uuid>
label
string
url
string<uri>
enabled
boolean
webhook_version
enum<string>
可用选项:
v1,
v2,
v3
secret_shared_key
string
secret_last4
string

目标当前签名密钥的最后四位字符,以便您区分不同的密钥。不足以用于验证签名。

previous_secret_expires_at
string<date-time> | null

在 Business Console 中轮换目标的签名密钥后设置 24 小时。在此期间,向该目标进行的每次投递还会携带使用被替换密钥生成的 X-Signature-Previous、X-Signature-V2-Previous 和 X-Signature-Simple-Previous(请参阅签名验证)。如果在过去 24 小时内未发生轮换,则为 null。

subscribed_events
enum<string>[]

此 Webhook 目标的事件过滤器。Didit 仅投递事件类型与这些值之一完全匹配的 Webhook,不支持通配符订阅。发送时,列表必须包含至少一个有效事件(显式传入 [] 将被拒绝并返回 400);列表为空的目标(创建时省略该字段)不会接收任何内容。更新时,列表会被整体替换,绝不会进行合并。

Minimum array length: 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
示例:
created_by_email
string | null

创建该目标的 Business Console 成员的邮箱。通过 API 密钥创建的目标为 null。

created_by_name
string | null

创建该目标的 Business Console 成员姓名。使用 API 密钥创建的目标为 null。

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

投递健康状态。failing:自该目标上次成功响应以来,已有 3 个或更多连续事件在首次投递尝试时失败(参见 failing_streak)。degraded:非 failing 状态,但在过去 24 小时内有一次投递尝试失败,且后续没有尝试成功投递该事件;成功投递该事件的重试或重新发送会清除此状态。healthy:均非上述情况。独立于 enabled。失败的尝试是指响应 HTTP 400 或以上,或者完全没有响应的尝试。

可用选项:
healthy,
degraded,
failing
failing_streak
integer

在最近 30 天内,自该目标上次成功响应以来,首次投递尝试失败的连续事件数量。重试不计入,任何成功的尝试(包括重试或重新发送)都会结束该连续记录。自上次成功以来没有事件失败时为 0。

failing_since
string<date-time> | null

当前 failing_streak 中第一次失败尝试的时间。当 failing_streak 为 0 时为 null。

last_success_at
string<date-time> | null

在过去 30 天内,目标上次以低于 400 的 HTTP 状态响应投递的时间。如果在此时间窗口内没有以低于 400 的 HTTP 状态响应,则为 null。

environment
enum<string>

拥有该目标的应用的环境。

可用选项:
live,
sandbox
summary
object

最近 metrics_window_days(30)天的投递指标。last_delivery_at 为最近一次尝试的时间,无论其何时发生。

最后修改于 2026年11月7日