GET /internal/email/suppressions
分页列出本租户被抑制的收件人（只返回掩码地址，不含 hash 与明文）
通信服务 - 内部接口 None application/json
请求参数
| 名称 | 位置 | 类型 | 必填 | 默认值 | 示例 | 约束 | 描述 |
|---|
X-Tenant-ID |
header |
string |
是 |
|
|
|
租户ID |
page |
query |
integer |
否 |
|
|
|
页码 |
page_size |
query |
integer |
否 |
|
|
|
每页条数 |
引用的 Schema
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 |
dto.SimpleResponse
| 字段 | 类型 | 必填 | 示例 | 约束 | 描述 |
|---|
code |
integer |
否 |
|
|
|
message |
string |
否 |
|
|
|
timestamp |
string |
否 |
|
|
|
service-communication/internal/handler/dto.EmailSuppressionListResponse
service-communication/internal/handler/dto.EmailSuppressionResponse
| 字段 | 类型 | 必填 | 示例 | 约束 | 描述 |
|---|
bounce_count |
integer |
否 |
3 |
|
|
created_at |
string |
否 |
2026-09-17T10:00:00Z |
|
|
email_masked |
string |
否 |
u***@example.com |
|
|
expires_at |
string |
否 |
2027-03-16T10:00:00Z |
|
ExpiresAt 保留期到期时间（U3）。空 = 不过期（保留期配置为 0，或本列引入前的历史行）。
运维需要它来回答「这条抑制为什么会被自动解除」与「历史行何时被回收」。 |
is_active |
boolean |
否 |
True |
|
|
last_bounced_at |
string |
否 |
2026-09-17T10:00:00Z |
|
|
provider |
string |
否 |
smtp |
|
|
reason |
string |
否 |
hard_bounce |
|
hard_bounce | soft_bounce | complaint |
