更新渠道类型
POST
/web/v1/notification-channel-types/command/updateWEB更新已有的通知渠道类型。支持部分更新。
鉴权
需要有效的 JWT token 和 Turnstile 验证。网关校验: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 | 渠道类型未找到 |
说明
- 仅更新非空字段;省略的字段保持不变。