跳转到主要内容
API Explorer|API Explorer
告警与响应相关接口/告警通道与集成
POSTAlerting起始版本 1.0同步需要认证

创建告警Webhook端点

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

调试可用性

在线调试

使用当前认证信息和示例参数提交 Mock 请求。

请求参数

请求体字段

  • nameString必填

    资源名称。

    示例： Slack Webhook

  • urlString必填

    目标地址Webhook投递。

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

  • signingEnabledBoolean必填

    是否启用HMAC签名。

    示例： true

  • signingSecretString必填

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

    示例： my-secret-key

响应状态

200 OK

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

  • endpointObject

    接收端地址。

    • idString

      资源ID。

      示例： wh-001

    • nameString

      资源名称。

      示例： Slack Webhook

    • urlString

      目标地址Webhook投递。

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

    • signingEnabledBoolean

      是否启用签名。

      示例： true

    • signingSecretMaskedString

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

      示例： ****abc1

    • createdAtString

      创建时间。

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

    • updatedAtString

      更新时间。

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

  • signingSecretPlaintextString

    签名密钥明文。

    示例： whsec_abc123def456

请求地址

POST/api/v1/alerting/webhook-endpoints

/api/v1/alerting/webhook-endpoints

操作 ID

CreateAlertWebhookEndpoint

永久链接

请求示例

curl -X POST '{host}/api/v1/alerting/webhook-endpoints' -H 'Authorization: Bearer {token}' -H 'Content-Type: application/json' -d '{"name":"Slack Webhook","url":"https://hooks.slack.com/services/T00/B00/xxx","signingEnabled":true,"signingSecret":"my-secret-key"}'

响应示例

200
{
  "endpoint": {},
  "signingSecretPlaintext": "whsec_abc123def456"
}

变更历史

此 API 暂无变更历史记录。

查看全部变更历史