更新通知端点
开放待确认。 查看适用范围。
PATCH /v1/webhook-endpoints/{id}
更新通知接收地址或启用状态。未传入的字段保持原值,签名密钥不变。
Attributes
| 属性 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
Idempotency-Key | header | string | 是 | 本次操作的唯一键;重试沿用原值 |
id | path | string | 是 | 端点的唯一标识 |
url | body | string | 否 | 新的通知接收地址,不能清空;地址要求与创建时相同 |
enabled | body | boolean | 否 | 是否启用通知投递;false 表示停用 |
请求示例
PATCH /v1/webhook-endpoints/we_example
Authorization: Bearer inv_test_...
Content-Type: application/json
Idempotency-Key: 65ded8e0-a034-49cb-8d7c-4b279a7382fd
{
"enabled": false
}
返回示例
200 OK,返回更新后的 Webhook Endpoint 对象,不包含 secret。
{
"id": "we_example",
"url": "https://merchant.example.com/webhooks/invisi",
"enabled": false,
"created_at": "2026-10-15T08:00:00Z",
"updated_at": "2026-10-15T08:10:00Z"
}