POST `/admin/announcements`

创建新的公告，支持草稿/定时发布，可指定目标租户和角色参考：CAN-SPAM Act (15 U.S.C. §7701) — Commercial Email Compliance。

通知服务 `bearerAuth` application/json

请求体

Schema： service-notification/internal/handler/dto.CreateAnnouncementRequest

字段	类型	必填	示例	约束	描述
`content`	`string`	是	`系统将于2026-05-15进行升级维护`
`title`	`string`	是	`系统升级公告`
`expire_at`	`string`	否	`2026-05-20T12:00:00Z`
`publish_at`	`string`	否	`2026-05-10T12:00:00Z`
`target_roles`	array of string	否

响应

状态	描述	Schema
201	创建成功	`service-notification/internal/handler/dto.AnnouncementDetailResponse`
400	请求参数错误	`service-core/base/dto.SimpleResponse`
401	未认证	`service-core/base/dto.SimpleResponse`
403	权限不足	`service-core/base/dto.SimpleResponse`
404	资源未找到	`service-core/base/dto.SimpleResponse`
500	服务内部错误	`service-core/base/dto.SimpleResponse`

引用的 Schema

service-core/base/dto.SimpleResponse

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

service-notification/internal/handler/dto.AnnouncementDetailResponse

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

service-notification/internal/handler/dto.AnnouncementResponse

公告信息响应

字段	类型	必填	示例	约束	描述
`content`	`string`	否	`系统将于2026-05-15进行升级维护`
`created_at`	`string`	否	`2026-05-09T12:00:00Z`
`dismissals`	`integer`	否	`5`
`expire_at`	`string`	否	`2026-05-20T12:00:00Z`
`id`	`string`	否	`ann_abc123`
`publish_at`	`string`	否	`2026-05-10T12:00:00Z`
`status`	`string`	否	`published`
`target_roles`	array of string	否
`tenant_id`	`string`	否	`tnt_xyz789`
`title`	`string`	否	`系统升级公告`
`updated_at`	`string`	否	`2026-05-09T12:00:00Z`
`views`	`integer`	否	`100`

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