PUT `/admin/communication/templates/{template_id}`

更新指定模板的名称、内容、变量列表等字段。更新后自动递增模板版本号，旧版本保留在版本历史中。支持修改模板的激活状态。参考：ePrivacy Directive 2002/58/EC、CAN-SPAM Act。

通信服务 `bearerAuth` application/json

请求参数

名称	位置	类型	必填	默认值	示例	约束	描述
`template_id`	`path`	`string`	是				模板ID

请求体

Schema： service-communication/internal/handler/dto.UpdateTemplateRequest

字段	类型	必填	示例	约束	描述
`content`	`string`	否	`您的验证码是{code}，10分钟内有效`
`content_type`	`string`	否	`text`
`description`	`string`	否	`更新版验证码模板`
`format`	`string`	否	`go-template`
`is_active`	`boolean`	否	`True`
`name`	`string`	否	`验证码模板v2`
`subject`	`string`	否	`验证码通知v2`
`text_content`	`string`	否	`Your code is {code}, valid for 10 min`
`variables`	array of string	否	`['["code"]']`

响应

状态	描述	Schema
200	更新成功，返回更新后的模板详情	`service-communication/internal/handler/dto.MessageTemplateDetailResponse`
400	请求参数错误	`dto.SimpleResponse`
401	未认证或令牌无效	`dto.SimpleResponse`
403	无权访问该资源	`dto.SimpleResponse`
404	模板不存在	`dto.SimpleResponse`
500	服务内部错误	`dto.SimpleResponse`

引用的 Schema

dto.SimpleResponse

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

service-communication/internal/handler/dto.MessageTemplateDetailResponse

字段	类型	必填	示例	约束	描述
`code`	`integer`	否
`data`	`service-communication/internal/handler/dto.MessageTemplateResponse`	否
`message`	`string`	否
`timestamp`	`string`	否

service-communication/internal/handler/dto.MessageTemplateResponse

消息模板数据

字段	类型	必填	示例	约束	描述
`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`

在 Scalar 中试用此 API → 下载 OpenAPI 规范（JSON）↓