POST /notifications/test

Send a test notification to the specified channel and target, creating a test notification record in the database to verify the notification service configuration. Reference: CAN-SPAM Act (15 U.S.C. §7701) — Commercial Email Compliance.

Request Body

Schema: dto.TestNotificationRequest

Field	Type	Required	Example	Constraints	Description
channel	string	Yes	email		Channel
target	string	Yes	user@example.com		Target

Responses

Status	Description	Schema
200	Test notification sent	dto.TestNotificationDetailResponse
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.TestNotificationDetailResponse

Field	Type	Required	Example	Constraints	Description
code	integer	No
data	dto.TestNotificationResponse	No
message	string	No

dto.TestNotificationResponse

Test notification send result

Field	Type	Required	Example	Constraints	Description
channel	string	No	email		Channel
status	string	No	sent		Status
target	string	No	user@example.com		Target
test_id	string	No	test-1234567890		Test ID

gitee_com_linmes_authms_base_dto.SimpleResponse

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