PUT /admin/announcements/{id}
编辑指定公告（仅在draft状态可编辑） 参考：CAN-SPAM Act (15 U.S.C. §7701) — Commercial Email Compliance。
通知服务 `bearerAuth` application/json
Request Parameters
| Name | In | Type | Required | Default | Example | Constraints | Description |
|---|
id |
path |
string |
Yes |
|
|
|
公告ID |
Request Body
Schema: dto.UpdateAnnouncementRequest
| Field | Type | Required | Example | Constraints | Description |
|---|
content |
string |
No |
|
|
|
expire_at |
string |
No |
|
|
|
publish_at |
string |
No |
|
|
|
target_roles |
array of
string |
No |
|
|
|
title |
string |
No |
|
|
|
Referenced Schemas
dto.AnnouncementDetailResponse
| Field | Type | Required | Example | Constraints | Description |
|---|
code |
integer |
No |
|
|
|
data |
dto.AnnouncementResponse |
No |
|
|
|
message |
string |
No |
|
|
|
timestamp |
string |
No |
|
|
|
dto.AnnouncementResponse
公告信息响应
| Field | Type | Required | Example | Constraints | Description |
|---|
content |
string |
No |
系统将于2026-05-15进行升级维护 |
|
|
created_at |
string |
No |
2026-05-09T12:00:00Z |
|
|
dismissals |
integer |
No |
5 |
|
|
expire_at |
string |
No |
2026-05-20T12:00:00Z |
|
|
id |
string |
No |
ann_abc123 |
|
|
publish_at |
string |
No |
2026-05-10T12:00:00Z |
|
|
status |
string |
No |
published |
|
|
target_roles |
array of
string |
No |
|
|
|
tenant_id |
string |
No |
tnt_xyz789 |
|
|
title |
string |
No |
系统升级公告 |
|
|
updated_at |
string |
No |
2026-05-09T12:00:00Z |
|
|
views |
integer |
No |
100 |
|
|
gitee_com_linmes_authms_base_dto.SimpleResponse
| Field | Type | Required | Example | Constraints | Description |
|---|
code |
integer |
No |
|
|
|
message |
string |
No |
|
|
|
timestamp |
string |
No |
|
|
|