/notifications/send-batch
向多个用户同时发送相同的通知消息,适用于系统公告、运营活动等场景 参考:CAN-SPAM Act (15 U.S.C. §7701) — Commercial Email Compliance。
Request Body
Schema: dto.BatchSendNotificationRequest
| Field | Type | Required | Example | Constraints | Description |
|---|---|---|---|---|---|
content |
string |
Yes | 您的账户已成功升级 |
内容 | |
title |
string |
Yes | 系统通知 |
标题 | |
user_ids |
array of string |
Yes | ['usr_001', 'usr_002'] |
用户ID列表 | |
priority |
string |
No | medium |
优先级 | |
type |
string |
No | system |
类型 |
Responses
| Status | Description | Schema |
|---|---|---|
| 201 | 批量发送成功 | dto.BatchSendNotificationDetailResponse |
| 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.BatchSendNotificationDetailResponse
| Field | Type | Required | Example | Constraints | Description |
|---|---|---|---|---|---|
code |
integer |
No | |||
data |
dto.BatchSendNotificationResponse |
No | |||
message |
string |
No |
dto.BatchSendNotificationResponse
批量发送通知结果
| Field | Type | Required | Example | Constraints | Description |
|---|---|---|---|---|---|
notification_ids |
array of string |
No | ['["ntf_001"]'] |
通知ID列表 | |
sent_count |
integer |
No | 5 |
发送数量 |
gitee_com_linmes_authms_base_dto.SimpleResponse
| Field | Type | Required | Example | Constraints | Description |
|---|---|---|---|---|---|
code |
integer |
No | |||
message |
string |
No | |||
timestamp |
string |
No |