GET /notifications/templates

获取所有通知模板列表,支持包含已停用模板的选项 参考:CAN-SPAM Act (15 U.S.C. §7701) — Commercial Email Compliance。

通知服务 `bearerAuth` application/json

请求参数

名称位置类型必填默认值示例约束描述
include_inactive query boolean 否 包含已停用模板
type query string 否 通知类型过滤
page query integer 否 页码(默认1)
page_size query integer 否 每页条数(默认20)

响应

引用的 Schema

service-core/base/dto.PageInfo

字段类型必填示例约束描述
has_next boolean 否 HasNext indicates whether there is a next page
has_prev boolean 否 HasPrev indicates whether there is a previous page
page integer 否 Page is the current page number (1-based)
page_size integer 否 PageSize is the number of items per page
total integer 否 Total is the total number of items across all pages
total_pages integer 否 TotalPages is the total number of pages

service-core/base/dto.SimpleResponse

字段类型必填示例约束描述
code integer 否
message string 否
timestamp string 否

service-notification/internal/handler/dto.TemplateListResponse

字段类型必填示例约束描述
code integer 否
items array of

参见 service-notification/internal/handler/dto.TemplateResponse

否 统一使用 items
message string 否
pagination object 否 分页信息(嵌套对象)
timestamp string 否
total integer 否 总条数(平铺,便于直接读取)

service-notification/internal/handler/dto.TemplateResponse

通知模板信息

字段类型必填示例约束描述
content string 否 亲爱的{{user_name}},欢迎加入{{app_name}}! 内容
created_at string 否 2026-01-01T00:00:00Z 创建时间
name string 否 welcome_notification 模板名称
subject string 否 欢迎加入{{app_name}} 主题
template_id string 否 tpl_abc123 模板ID
type string 否 system 类型
variables array of

string

否 ['["user_name"', '"app_name"]'] 变量