GET /admin/notifications

管理员按 user_id 查询指定用户的通知历史记录,支持按类型、已读状态、日期范围筛选

通知服务 `bearerAuth` application/json

请求参数

名称位置类型必填默认值示例约束描述
user_id query string 是 用户ID
page query integer 否 页码
page_size query integer 否 每页条数
type query string 否 通知类型
is_read query boolean 否 是否已读
start_date query string 否 开始日期
end_date query string 否 结束日期

响应

引用的 Schema

dto.ListResponse-service-notification/internal/handler/dto/NotificationResponse

字段类型必填示例约束描述
code integer 否
items array of

参见 service-notification/internal/handler/dto.NotificationResponse

否 统一使用 items
message string 否
pagination object 否 分页信息(嵌套对象)
timestamp string 否
total integer 否 总条数(平铺,便于直接读取)

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.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