Webhook

轮换 Webhook 签名密钥

POST /api/webhooks/endpoints/{id}/rotate-secret
POST/api/webhooks/endpoints/{id}/rotate-secret

要求 Cookie、CSRF、owner 与 api-token 强验证。轮换立即推进版本并取消旧代未完成投递,没有双密钥重叠期;新 signingSecret 只显示一次。

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

路径参数

idstring必填

长度 ≥ 1

请求体 必填

application/json

返回值

成功;无额外 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

signingSecretstring必填

仅创建或轮换时显示一次;作为 UTF-8 字符串保存到接收端私密环境,不是 OAuth client secret。

响应头

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

接口: POST /api/webhooks/endpoints/{id}/rotate-secret
operationId: rotateWebhookSecret

要求 Cookie、CSRF、owner 与 api-token 强验证。轮换立即推进版本并取消旧代未完成投递,没有双密钥重叠期;新 signingSecret 只显示一次。

参数:

  • path id(必填)