GET /admin/notifications
Admin queries notification history for a specified user by user_id, supporting filtering by type, read status, and date range.
Notification Service `bearerAuth` application/json
Request Parameters
| Name | In | Type | Required | Default | Example | Constraints | Description |
|---|
user_id |
query |
string |
Yes |
|
|
|
User ID |
page |
query |
integer |
No |
|
|
|
Page number |
page_size |
query |
integer |
No |
|
|
|
Items per page |
type |
query |
string |
No |
|
|
|
Notification type |
is_read |
query |
boolean |
No |
|
|
|
Read status |
start_date |
query |
string |
No |
|
|
|
Start date |
end_date |
query |
string |
No |
|
|
|
End date |
Referenced Schemas
dto.ListResponse-dto_NotificationResponse
| Field | Type | Required | Example | Constraints | Description |
|---|
code |
integer |
No |
|
|
|
items |
array of
See dto.NotificationResponse |
No |
|
|
Unified use of items |
message |
string |
No |
|
|
|
pagination |
object |
No |
|
|
Pagination info (nested object) |
timestamp |
string |
No |
|
|
|
total |
integer |
No |
|
|
Total count (flattened for direct reading) |
dto.NotificationResponse
Notification info response
| Field | Type | Required | Example | Constraints | Description |
|---|
action_url |
string |
No |
/security |
|
Action link |
content |
string |
No |
Your account has been successfully upgraded |
|
Content |
created_at |
string |
No |
2026-04-15T10:30:00Z |
|
Creation time |
event_type |
string |
No |
status.incident.created |
|
|
id |
string |
No |
ntf_abc123 |
|
Notification ID |
is_read |
boolean |
No |
False |
|
Is read |
metadata |
string |
No |
{"ip":"1.2.3.4"} |
|
Metadata JSON |
priority |
string |
No |
medium |
|
Priority |
read_at |
string |
No |
2026-04-15T11:00:00Z |
|
Read time |
tenant_id |
string |
No |
tnt_xyz789 |
|
Tenant ID |
title |
string |
No |
System notification |
|
Title |
type |
string |
No |
system |
|
Type |
user_id |
string |
No |
usr_abc123 |
|
User ID |
gitee_com_linmes_authms_base_dto.PageInfo
| Field | Type | Required | Example | Constraints | Description |
|---|
has_next |
boolean |
No |
|
|
HasNext indicates whether there is a next page |
has_prev |
boolean |
No |
|
|
HasPrev indicates whether there is a previous page |
page |
integer |
No |
|
|
Page is the current page number (1-based) |
page_size |
integer |
No |
|
|
PageSize is the number of items per page |
total |
integer |
No |
|
|
Total is the total number of items across all pages |
total_pages |
integer |
No |
|
|
TotalPages is the total number of pages |
gitee_com_linmes_authms_base_dto.SimpleResponse
| Field | Type | Required | Example | Constraints | Description |
|---|
code |
integer |
No |
|
|
|
message |
string |
No |
|
|
|
timestamp |
string |
No |
|
|
|
Autional API Wiki