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

保存告警SMTP配置

保存更新全局SMTP配置邮箱通知。

调试可用性

在线调试

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

请求参数

请求体字段

  • hostString必填

    主机地址。

    示例： smtp.example.com

  • portInteger必填

    端口号。

    示例： 587

  • encryptionString必填

    模式无SSL starttls。

    示例： starttls

  • usernameString必填

    用户名。

    示例： alerts@example.com

  • passwordString必填

    密码。

    示例： secret

响应状态

200 OK

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

  • hostString

    主机地址。

    示例： smtp.example.com

  • portInteger

    端口号。

    示例： 587

  • encryptionString

    模式无SSL starttls。

    示例： starttls

  • usernameString

    用户名。

    示例： alerts@example.com

  • fromAddrString

    发送者邮箱地址。

    示例： alerts@example.com

  • fromNameString

    发送者显示名称。

    示例： ZCF Alerts

  • createDateString

    创建时间。

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

  • lastOpDateString

    最近一次操作时间。

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

请求地址

PUT/api/v1/alerting/smtp-config

/api/v1/alerting/smtp-config

操作 ID

SaveAlertSmtpConfig

永久链接

请求示例

curl -X PUT '{host}/api/v1/alerting/smtp-config' -H 'Authorization: Bearer {token}' -H 'Content-Type: application/json' -d '{"host":"smtp.example.com","port":587,"encryption":"starttls","username":"alerts@example.com","password":"secret","fromAddr":"alerts@example.com","fromName":"ZCF Alerts"}'

响应示例

200
{
  "host": "smtp.example.com",
  "port": 587,
  "encryption": "starttls",
  "username": "alerts@example.com",
  "fromAddr": "alerts@example.com",
  "fromName": "ZCF Alerts",
  "createDate": "example",
  "lastOpDate": "example"
}

变更历史

此 API 暂无变更历史记录。

查看全部变更历史