Webhook

修改 Webhook 端点

PATCH /api/webhooks/endpoints/{id}
PATCH/api/webhooks/endpoints/{id}

只接受当前网站 Cookie 会话;须为 owner,并持有匹配 Cookie 的 x-csrf-token 及当前会话用途 api-token 的二次验证(300 秒)。Origin/Fetch Metadata 和锁后期限复核仍生效。PAT/OAuth access 不可调用。

网站 Cookie 会话 + CSRF + 二次验证(api-token,300 秒);请在同源网站环境调用

路径参数

idstring必填

长度 ≥ 1

请求体 必填

application/json
namestring可选

去首尾空格后校验长度。

长度 ≥ 1 · 长度 ≤ 100

urlstring可选

公网域名 HTTPS/443;禁止凭据、片段、IP literal、非公网 DNS 和重定向。每次投递重新验证 DNS 并固定实际连接目标。

长度 ≤ 2048 · 格式:uri

enabledboolean可选

返回值

成功;无额外 data 信封。

endpointobject必填
idstring必填
namestring必填
urlstring必填

格式:uri

clientIdstring | null必填
enabledboolean必填
reviewStatusstring必填
可选值"pending""approved""rejected"
reviewedAtstring | null必填

格式:date-time

reviewNotestring必填
versionstring必填

格式:^[0-9]+$

createdAtstring必填

格式:date-time

updatedAtstring必填

格式:date-time

响应头

Cache-Controlstring可选
可选值"no-store"
接口信息

接口: PATCH /api/webhooks/endpoints/{id}
operationId: updateWebhookEndpoint

只接受当前网站 Cookie 会话;须为 owner,并持有匹配 Cookie 的 x-csrf-token 及当前会话用途 api-token 的二次验证(300 秒)。Origin/Fetch Metadata 和锁后期限复核仍生效。PAT/OAuth access 不可调用。

参数:

  • path id(必填)
  • body name:去首尾空格后校验长度。
  • body url:公网域名 HTTPS/443;禁止凭据、片段、IP literal、非公网 DNS 和重定向。每次投递重新验证 DNS 并固定实际连接目标。
  • body enabled