跳转到主要内容
ZStack
告警与响应相关接口/告警通道与集成

轮换告警Webhook密钥

轮换HMAC签名密钥Webhook端点。

POST/api/v1/alerting/webhook-endpoints/{endpointId}/rotate-secret

操作 ID

RotateAlertWebhookSecret

起始版本

1.0.0

执行模式

同步

认证信息

需要认证

认证信息

调用该 API 时需要在请求头中携带以下认证信息。

Authorizationstring必填

Bearer 令牌

X-Tenant-IDstring

X-Tenant-ID

请求参数

路径参数

  • endpointId
    String必填

    端点标识符轮换密钥。

响应状态

200 OK
200 OK

该 API 成功时返回以下响应结构。

  • endpoint
    Object

    接收端地址。

    • id
      String

      资源ID。

      示例： wh-001

    • name
      String

      资源名称。

      示例： Slack Webhook

    • url
      String

      目标URL Webhook投递。

      示例： https://hooks.slack.com/services/T00/B00/xxx

    • signingEnabled
      Boolean

      是否启用签名。

      示例： true

    • signingSecretMasked
      String

      已脱敏签名密钥最近一次4字符可见。

      示例： ****abc1

    • createdAt
      String

      创建时间。

      示例： 2026-01-15T08:00:00Z

    • updatedAt
      String

      更新时间。

      示例： 2026-01-15T08:00:00Z

  • signingSecretPlaintext
    String

    新明文签名密钥显示一次。

    示例： whsec_new789ghi012