创建通知渠道

POST/web/v1/notification-channels/command/createWEB

创建一个新的通知渠道。目前支持 EMAIL 渠道类型。

鉴权

需要有效的 JWT token 和 Turnstile 验证。Gateway 校验：enableJwtToken=true, enableTurnstile=true。

请求参数

请求体

NotificationChannelCreateRequest:

Name	Type	Required	In	Description
institutionBizId	string	Yes	body	机构业务 ID（最长 64 字符）
channelName	string	Yes	body	渠道名称（最长 255 字符）
channelRemark	string	No	body	渠道备注（最长 255 字符）
channelHost	string	Yes	body	渠道主机/接入端点（最长 512 字符）
channelCategory	string	Yes	body	渠道分类枚举：EMAIL
emailConfig	object	No	body	邮箱配置（channelCategory 为 EMAIL 时必填）
emailConfig.smtpHost	string	Yes	body	SMTP 服务器主机名
emailConfig.smtpPort	integer	Yes	body	SMTP 服务器端口（1-65535）
emailConfig.senderEmail	string	Yes	body	发件人邮箱地址
emailConfig.senderName	string	Yes	body	发件人显示名称
emailConfig.username	string	Yes	body	SMTP 认证用户名
emailConfig.password	string	Yes	body	SMTP 认证密码
emailConfig.useSsl	boolean	No	body	使用 SSL 加密（默认：true）
emailConfig.useStartTls	boolean	No	body	使用 STARTTLS（默认：false）
emailConfig.connectionTimeout	integer	No	body	连接超时时间（毫秒，默认：10000）
emailConfig.readTimeout	integer	No	body	读取超时时间（毫秒，默认：30000）

成功响应

成功200

{
  "code": "2000",
  "message": "SUCCESS",
  "data": {
    "bizId": "ch_abc123",
    "institutionBizId": "inst_abc123",
    "channelName": "Main Email",
    "channelRemark": null,
    "channelHost": "smtp.example.com",
    "channelCategory": "EMAIL",
    "channelStatus": "PENDING",
    "emailConfig": {
      "smtpHost": "smtp.example.com",
      "smtpPort": 587,
      "senderEmail": "noreply@example.com",
      "senderName": "Acme Corp",
      "username": "noreply@example.com",
      "password": "******",
      "useSsl": true,
      "useStartTls": false,
      "connectionTimeout": 10000,
      "readTimeout": 30000
    },
    "createdAt": "2026-03-21T00:00:00Z",
    "updatedAt": "2026-03-21T00:00:00Z",
    "createdBy": "user_xyz",
    "updatedBy": "user_xyz"
  }
}

错误响应

错误码	描述
4000	校验错误（缺少必填字段、邮箱配置无效）
4010	未授权（JWT token 无效或缺失）
4030	Turnstile 验证失败

说明

• 出于安全考虑，响应中的密码以 ****** 脱敏显示。
• 当 channelCategory 为 EMAIL 时，emailConfig 对象为必填。
• 渠道创建时初始状态为 PENDING。