POST /communication/bulk

Send bulk SMS or email to multiple recipients. Supports template variable substitution, records send status per item, suitable for marketing notifications, system announcements, and other bulk communication scenarios. References: ePrivacy Directive 2002/58/EC, CAN-SPAM Act.

Request Body

Schema: dto.BulkSendRequest

Field	Type	Required	Example	Constraints	Description
channel	string	Yes	sms	enum: `sms`, `email`
content	string	Yes	Your verification code is 123456
recipients	array of string	Yes	['["13800138000"', '"13900139000"]']
subject	string	No	Notification
template	string	No	verify_code
user_id	string	No	usr_abc123
variables	object	No		extra keys: `string`

Responses

Status	Description	Schema
200	Bulk send successful, returns list of individual logs	dto.CommunicationLogListResponse
400	Invalid request parameters	dto.SimpleResponse
401	Unauthenticated or invalid token	dto.SimpleResponse
403	Insufficient permissions to access this resource	dto.SimpleResponse
404	Resource not found	dto.SimpleResponse
500	Internal server error	dto.SimpleResponse

Referenced Schemas

dto.CommunicationLogListResponse

Field	Type	Required	Example	Constraints	Description
code	integer	No
items	array of See dto.CommunicationLogResponse	No			Unified use items
message	string	No
pagination	object	No			Pagination information (nested object)
timestamp	string	No
total	integer	No			Total count (flat, for easy reading)

dto.CommunicationLogResponse

Message send log record

Field	Type	Required	Example	Constraints	Description
channel	string	No	sms
content	string	No	Your verification code is 123456
created_at	string	No	2026-04-15T10:00:00Z
error	string	No	Send timeout
id	string	No	log_abc123
provider	string	No	aliyun
recipient	string	No	138****8000
response	string	No
sent_at	string	No	2026-04-15T10:01:00Z
status	string	No	delivered
template_id	string	No	tpl_abc123
tenant_id	string	No	tnt_xyz789
updated_at	string	No	2026-04-15T10:00:00Z
user_id	string	No	usr_abc123

dto.PageInfo

Field	Type	Required	Example	Constraints	Description
has_next	boolean	No			HasNext indicates whether there is a next page
has_prev	boolean	No			HasPrev indicates whether there is a previous page
page	integer	No			Page is the current page number (1-based)
page_size	integer	No			PageSize is the number of items per page
total	integer	No			Total is the total number of items across all pages
total_pages	integer	No			TotalPages is the total number of pages

dto.SimpleResponse

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