创建渠道类型
POST
/web/v1/notification-channel-types/command/createWEB创建新的通知渠道类型定义。
鉴权
需要有效的 JWT token 和 Turnstile 验证。网关校验:enableJwtToken=true,enableTurnstile=true。
请求参数
请求体
NotificationChannelTypeCreateRequest:
| Name | Type | Required | In | Description |
|---|---|---|---|---|
channelCategory | string | Yes | body | 渠道类别枚举:EMAIL |
typeName | string | Yes | body | 类型显示名称(最多 128 个字符) |
typeDescription | string | No | body | 类型描述(最多 512 个字符) |
displayOrder | integer | No | body | 显示排序顺序(默认值:0) |
iconUrl | string | No | body | 图标 URL(最多 512 个字符) |
extraConfig | string | No | body | 扩展配置(JSON 字符串) |
成功响应
成功200
{
"code": "2000",
"message": "SUCCESS",
"data": {
"bizId": "ct_abc123",
"typeCode": "EMAIL",
"typeValue": 80010101,
"typeName": "Email Notification",
"typeDescription": "Standard email delivery",
"typeStatus": "ENABLED",
"displayOrder": 0,
"iconUrl": null,
"extraConfig": null,
"createdAt": "2026-03-21T00:00:00Z",
"updatedAt": "2026-03-21T00:00:00Z"
}
}错误响应
| 错误码 | 描述 |
|---|---|
4000 | 校验错误(缺少必填字段) |
4010 | 未授权(无效或缺少 JWT token) |
4030 | Turnstile 验证失败 |
说明
typeCode和typeValue从channelCategory枚举推导而来。- 渠道类型默认以
ENABLED状态创建。