/admin/announcements/{announcement_id}
编辑指定公告（仅在draft状态可编辑） 参考：CAN-SPAM Act (15 U.S.C. §7701) — Commercial Email Compliance。
请求参数
| 名称 | 位置 | 类型 | 必填 | 默认值 | 示例 | 约束 | 描述 |
|---|---|---|---|---|---|---|---|
announcement_id |
path |
string |
是 | 公告ID |
请求体
Schema： service-notification/internal/handler/dto.UpdateAnnouncementRequest
| 字段 | 类型 | 必填 | 示例 | 约束 | 描述 |
|---|---|---|---|---|---|
content |
string |
否 | |||
expire_at |
string |
否 | |||
publish_at |
string |
否 | |||
target_roles |
array of string |
否 | |||
title |
string |
否 |
响应
引用的 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 |