POST /notifications
向指定用户发送一条通知消息，支持多种通知类型，记录发送状态并触发事件通知 参考：CAN-SPAM Act (15 U.S.C. §7701) — Commercial Email Compliance。
通知服务 `bearerAuth` application/json
Request Body
Schema: dto.SendNotificationRequest
| Field | Type | Required | Example | Constraints | Description |
|---|
content |
string |
Yes |
您的账户已成功升级 |
|
内容 |
title |
string |
Yes |
系统通知 |
|
标题 |
user_id |
string |
Yes |
usr_abc123 |
|
用户ID |
aggregation_key |
string |
No |
new_follower |
|
聚合键（同key通知聚合为一条） |
metadata |
object |
No |
|
|
元数据 |
priority |
string |
No |
medium |
|
优先级 |
type |
string |
No |
system |
|
类型 |
Referenced Schemas
dto.NotificationDetailResponse
| Field | Type | Required | Example | Constraints | Description |
|---|
code |
integer |
No |
|
|
|
data |
dto.NotificationResponse |
No |
|
|
|
message |
string |
No |
|
|
|
timestamp |
string |
No |
|
|
|
dto.NotificationResponse
通知信息响应
| Field | Type | Required | Example | Constraints | Description |
|---|
action_url |
string |
No |
/security |
|
操作链接 |
content |
string |
No |
您的账户已成功升级 |
|
内容 |
created_at |
string |
No |
2026-04-15T10:30:00Z |
|
创建时间 |
event_type |
string |
No |
status.incident.created |
|
|
id |
string |
No |
ntf_abc123 |
|
通知ID |
is_read |
boolean |
No |
False |
|
是否已读 |
metadata |
string |
No |
{"ip":"1.2.3.4"} |
|
元数据JSON |
priority |
string |
No |
medium |
|
优先级 |
read_at |
string |
No |
2026-04-15T11:00:00Z |
|
阅读时间 |
tenant_id |
string |
No |
tnt_xyz789 |
|
租户ID |
title |
string |
No |
系统通知 |
|
标题 |
type |
string |
No |
system |
|
类型 |
user_id |
string |
No |
usr_abc123 |
|
用户ID |
gitee_com_linmes_authms_base_dto.SimpleResponse
| Field | Type | Required | Example | Constraints | Description |
|---|
code |
integer |
No |
|
|
|
message |
string |
No |
|
|
|
timestamp |
string |
No |
|
|
|