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

轮换告警Webhook密钥

轮换HMAC签名密钥Webhook端点。

调试可用性

在线调试

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

路径参数

请求参数

路径参数

  • endpointIdString必填

    端点标识符轮换密钥。

响应状态

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_new789ghi012

请求地址

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

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

操作 ID

RotateAlertWebhookSecret

永久链接

请求示例

curl -X POST '{host}/api/v1/alerting/webhook-endpoints/{endpointId}/rotate-secret' -H 'Authorization: Bearer {token}' -H 'Content-Type: application/json' -d '{}'

响应示例

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

变更历史

此 API 暂无变更历史记录。

查看全部变更历史