GET /communication/templates

分页查询当前租户的消息模板列表。支持按发送渠道(sms/email/push)、激活状态、关键词(模板名称/编码)进行筛选。参考:ePrivacy Directive 2002/58/EC、CAN-SPAM Act。

通信服务 `bearerAuth` application/json

请求参数

名称位置类型必填默认值示例约束描述
channel query string 否 渠道筛选:sms/email/push
is_active query boolean 否 是否激活筛选:true/false
keyword query string 否 关键词搜索(匹配模板名称或编码)
page query integer 否 页码,从1开始(默认1)
page_size query integer 否 每页条数(默认20)

响应

状态描述Schema
200查询成功,返回模板列表service-communication/internal/handler/dto.TemplateListResponse
400请求参数错误dto.SimpleResponse
401未认证或令牌无效dto.SimpleResponse
403无权访问该资源dto.SimpleResponse
500服务内部错误dto.SimpleResponse

引用的 Schema

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

dto.SimpleResponse

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

service-communication/internal/handler/dto.TemplateListResponse

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

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

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

service-communication/internal/handler/dto.TemplateResponse

模板数据

字段类型必填示例约束描述
channel string 否 sms
code string 否 verify_code
content string 否 您的验证码是{code},5分钟内有效
content_type string 否 text
created_at string 否 2026-04-15T10:00:00Z
description string 否 用于发送登录验证码
id string 否 tpl_abc123
is_active boolean 否 True
name string 否 验证码模板
subject string 否 验证码通知
tenant_id string 否 tnt_xyz789
updated_at string 否 2026-04-15T10:00:00Z
variables array of

string

否 ['["code"]']
version integer 否 1