查询渠道类型
POST
/web/v1/notification-channel-types/queryWEB查询通知渠道类型,支持可选筛选条件。返回分页结果。
鉴权
需要有效的 JWT token 和 Turnstile 验证。网关校验:enableJwtToken=true,enableTurnstile=true。
请求参数
请求体
NotificationChannelTypeQueryRequest:
| Name | Type | Required | In | Description |
|---|---|---|---|---|
bizId | string | No | body | 按类型业务 ID 筛选(最多 64 个字符) |
typeCode | string | No | body | 按类型代码筛选(最多 32 个字符,例如 EMAIL) |
typeStatus | string | No | body | 按状态筛选:ENABLED、DISABLED |
enabledOnly | boolean | No | body | 若为 true,仅返回已启用的类型 |
查询参数
| Name | Type | Required | In | Description |
|---|---|---|---|---|
page | integer | No | query | 页码(从 0 开始) |
size | integer | No | query | 每页大小 |
sort | string | No | query | 排序字段和方向(例如 displayOrder,asc) |
成功响应
成功200
{
"code": "2000",
"message": "SUCCESS",
"data": {
"content": [
{
"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"
}
],
"totalElements": 1,
"totalPages": 1,
"number": 0,
"size": 20
}
}错误响应
| 错误码 | 描述 |
|---|---|
4010 | 未授权(无效或缺少 JWT token) |
4030 | Turnstile 验证失败 |
说明
- 所有筛选字段均为可选;省略时返回所有渠道类型。
- 响应使用 Spring Data
Page格式。