POST /notifications

Send a notification message to a specified user, supporting multiple notification types, recording send status and triggering event notifications. Reference: CAN-SPAM Act (15 U.S.C. §7701) — Commercial Email Compliance.

Request Body

Schema: dto.SendNotificationRequest

Field	Type	Required	Example	Constraints	Description
content	string	Yes	Your account has been successfully upgraded		Content
title	string	Yes	System notification		Title
user_id	string	Yes	usr_abc123		User ID
aggregation_key	string	No	new_follower		Aggregation key (notifications with the same key are aggregated into one)
metadata	object	No			Metadata
priority	string	No	medium		Priority
type	string	No	system		Type

Responses

Status	Description	Schema
201	Sent successfully	dto.NotificationDetailResponse
400	Invalid request parameters	gitee_com_linmes_authms_base_dto.SimpleResponse
401	Unauthenticated	gitee_com_linmes_authms_base_dto.SimpleResponse
403	Insufficient permissions	gitee_com_linmes_authms_base_dto.SimpleResponse
404	Resource not found	gitee_com_linmes_authms_base_dto.SimpleResponse
500	Internal server error	gitee_com_linmes_authms_base_dto.SimpleResponse

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

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

Field	Type	Required	Example	Constraints	Description
code	integer	No
message	string	No
timestamp	string	No