POST `/notifications`

向指定用户发送一条通知消息，支持多种通知类型，记录发送状态并触发事件通知参考：CAN-SPAM Act (15 U.S.C. §7701) — Commercial Email Compliance。

通知服务 `bearerAuth` application/json

请求体

Schema： service-notification/internal/handler/dto.SendNotificationRequest

字段	类型	必填	示例	约束	描述
`content`	`string`	是	`您的账户已成功升级`		内容
`title`	`string`	是	`系统通知`		标题
`user_id`	`string`	是	`usr_abc123`		用户ID
`aggregation_key`	`string`	否	`new_follower`		聚合键（同key通知聚合为一条）
`metadata`	`object`	否			元数据
`priority`	`string`	否	`medium`		优先级
`type`	`string`	否	`system`		类型

响应

状态	描述	Schema
201	发送成功	`service-notification/internal/handler/dto.NotificationDetailResponse`
400	请求参数错误	`service-core/base/dto.SimpleResponse`
401	未认证	`service-core/base/dto.SimpleResponse`
403	权限不足	`service-core/base/dto.SimpleResponse`
404	资源未找到	`service-core/base/dto.SimpleResponse`
500	服务内部错误	`service-core/base/dto.SimpleResponse`

引用的 Schema

service-core/base/dto.SimpleResponse

字段	类型	必填	示例	约束	描述
`code`	`integer`	否
`message`	`string`	否
`timestamp`	`string`	否

service-notification/internal/handler/dto.NotificationDetailResponse

字段	类型	必填	示例	约束	描述
`code`	`integer`	否
`data`	`service-notification/internal/handler/dto.NotificationResponse`	否
`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

在 Scalar 中试用此 API → 下载 OpenAPI 规范（JSON）↓