GET /announcements
分页查询公告列表，支持按状态过滤和关键词搜索 参考：CAN-SPAM Act (15 U.S.C. §7701) — Commercial Email Compliance。
通知服务 `bearerAuth` application/json
请求参数
| 名称 | 位置 | 类型 | 必填 | 默认值 | 示例 | 约束 | 描述 |
|---|
page |
query |
integer |
否 |
1 |
|
|
页码 |
page_size |
query |
integer |
否 |
20 |
|
|
每页条数 |
status |
query |
string |
否 |
|
|
|
状态过滤: draft/scheduled/published/expired |
search |
query |
string |
否 |
|
|
|
搜索关键词 |
引用的 Schema
service-core/base/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 |
service-core/base/dto.SimpleResponse
| 字段 | 类型 | 必填 | 示例 | 约束 | 描述 |
|---|
code |
integer |
否 |
|
|
|
message |
string |
否 |
|
|
|
timestamp |
string |
否 |
|
|
|
service-notification/internal/handler/dto.AnnouncementListResponse
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 |
|
|
