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

创建告警Webhook端点

创建新Webhook端点可选HMAC签名。

POST/api/v1/alerting/webhook-endpoints

操作 ID

CreateAlertWebhookEndpoint

起始版本

1.0.0

执行模式

同步

认证信息

需要认证

认证信息

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

Authorizationstring必填

Bearer 令牌

X-Tenant-IDstring

X-Tenant-ID

请求参数

application/json

请求体字段

  • name
    String必填

    资源名称。

    示例： Slack Webhook

  • url
    String必填

    目标URL Webhook投递。

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

  • signingEnabled
    Boolean必填

    是否启用HMAC签名。

    示例： true

  • signingSecret
    String必填

    初始签名密钥自动生成空。

    示例： my-secret-key

响应状态

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_abc123def456