Skip to content

更新渠道类型

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

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

鉴权

需要有效的 JWT token 和 Turnstile 验证。Gateway 校验:enableJwtToken=true, enableTurnstile=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渠道类型未找到

说明

  • 仅更新非 null 字段;未提供的字段保持不变。

内部文档