更新渠道类型
POST
/web/v1/notification-channel-types/command/updateWEB更新已有的通知渠道类型。支持部分更新。
鉴权
需要有效的 JWT token 和 Turnstile 验证。Gateway 校验:enableJwtToken=true, enableTurnstile=true。
请求参数
请求体
NotificationChannelTypeUpdateRequest:
| Name | Type | Required | In | Description |
|---|---|---|---|---|
bizId | string | Yes | body | 类型业务 ID(最长 64 字符) |
typeName | string | No | body | 新的类型名称(最长 128 字符) |
typeDescription | string | No | body | 新的类型描述(最长 512 字符) |
typeStatus | string | No | body | 新的状态:ENABLED, DISABLED |
displayOrder | integer | No | body | 新的显示排序 |
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": "Updated Email Type",
"typeDescription": "Updated description",
"typeStatus": "ENABLED",
"displayOrder": 1,
"iconUrl": null,
"extraConfig": null,
"createdAt": "2026-03-21T00:00:00Z",
"updatedAt": "2026-03-21T01:00:00Z"
}
}错误响应
| 错误码 | 描述 |
|---|---|
4000 | 校验错误(缺少 bizId) |
4010 | 未授权(JWT token 无效或缺失) |
4030 | Turnstile 验证失败 |
4040 | 渠道类型未找到 |
说明
- 仅更新非 null 字段;未提供的字段保持不变。