Skip to content

更新渠道类型

POST/web/v1/notification-channel-types/command/updateWEB

更新已有的通知渠道类型。支持部分更新。

鉴权

需要有效的 JWT token 和 Turnstile 验证。网关校验:enableJwtToken=trueenableTurnstile=true

请求参数

请求体

NotificationChannelTypeUpdateRequest

NameTypeRequiredInDescription
bizIdstringYesbody类型业务 ID(最多 64 个字符)
typeNamestringNobody新类型名称(最多 128 个字符)
typeDescriptionstringNobody新类型描述(最多 512 个字符)
typeStatusstringNobody新状态:ENABLED、DISABLED
displayOrderintegerNobody新显示排序顺序
iconUrlstringNobody新图标 URL(最多 512 个字符)
extraConfigstringNobody新扩展配置(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)
4030Turnstile 验证失败
4040渠道类型未找到

说明

  • 仅更新非空字段;省略的字段保持不变。

内部文档