GET /notifications/unread
获取当前用户的所有未读通知列表 参考:CAN-SPAM Act (15 U.S.C. §7701) — Commercial Email Compliance。
通知服务 `bearerAuth` application/json
引用的 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.NotificationListResponse
service-notification/internal/handler/dto.NotificationResponse
通知信息响应
| 字段 | 类型 | 必填 | 示例 | 约束 | 描述 |
action_url |
string |
否 |
/security |
|
操作链接 |
content |
string |
否 |
您的账户已成功升级 |
|
内容 |
created_at |
string |
否 |
2026-04-15T10:30:00Z |
|
创建时间 |
event_type |
string |
否 |
status.incident.created |
|
|
id |
string |
否 |
ntf_abc123 |
|
通知ID |
is_read |
boolean |
否 |
False |
|
是否已读 |
metadata |
string |
否 |
{"ip":"1.2.3.4"} |
|
元数据JSON |
priority |
string |
否 |
medium |
|
优先级 |
read_at |
string |
否 |
2026-04-15T11:00:00Z |
|
阅读时间 |
tenant_id |
string |
否 |
tnt_xyz789 |
|
租户ID |
title |
string |
否 |
系统通知 |
|
标题 |
type |
string |
否 |
system |
|
类型 |
user_id |
string |
否 |
usr_abc123 |
|
用户ID |