A AuthMS API Wiki API Reference iam.tianv.com →

POST /notifications/send

与 /notifications 相同功能的兼容端点,向指定用户发送通知 参考:CAN-SPAM Act (15 U.S.C. §7701) — Commercial Email Compliance。

通知服务 `bearerAuth` application/json

Request Body

Schema: dto.SendNotificationRequest

FieldTypeRequiredExampleConstraintsDescription
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 类型

Responses

StatusDescriptionSchema
200发送成功dto.SendNotificationCompatDetailResponse
400请求参数错误gitee_com_linmes_authms_base_dto.SimpleResponse
401未认证gitee_com_linmes_authms_base_dto.SimpleResponse
403权限不足gitee_com_linmes_authms_base_dto.SimpleResponse
404资源未找到gitee_com_linmes_authms_base_dto.SimpleResponse
500服务内部错误gitee_com_linmes_authms_base_dto.SimpleResponse

Referenced Schemas

dto.SendNotificationCompatDetailResponse

FieldTypeRequiredExampleConstraintsDescription
code integer No
data dto.SendNotificationCompatResponse No
message string No
timestamp string No

dto.SendNotificationCompatResponse

发送通知的响应结果(兼容端点)

FieldTypeRequiredExampleConstraintsDescription
id string No notif-1234567890 通知ID
status string No sent 状态

gitee_com_linmes_authms_base_dto.SimpleResponse

FieldTypeRequiredExampleConstraintsDescription
code integer No
message string No
timestamp string No