发送单封与批量邮件
通过单封或批量接口提交邮件，并处理邮件用途、整批校验、逐封结果、幂等和重试。
单封接口用于提交一封邮件；批量接口用于在一个请求中提交多封相互独立的邮件。两个接口均采用异步处理：平台先返回受理结果，再逐封完成投递。
批量受理不等于整批送达
批量请求在受理前执行整批校验；受理成功后，每封邮件独立处理并产生自己的 Message ID 和最终状态。
选择发送方式
| 场景 | 推荐接口 | 说明 |
|---|---|---|
| 发送一封业务通知 | 单封发送 | 返回一个 Message ID。 |
| 一次提交多封独立邮件 | 批量发送 | 每个子项对应一封邮件，最多 100 项。 |
| 向多位联系人发送营销内容 | 批量发送 | 每位联系人使用一个独立邮件对象，避免暴露其他收件人。 |
| 由客户运营人员管理受众和定时计划 | 群发活动 | 在控制台完成受众选择、测试发送、审核和调度。 |
新接入可使用以下接口：
| 接口 | 路径 | 成功受理 |
|---|---|---|
| 单封发送 | POST /innomail/v2/messages/send | HTTP 202 + code=000000 |
| 批量发送 | POST /innomail/v2/messages/batchsend | HTTP 202 + code=000000 |
邮件用途
每封邮件都应声明真实用途：
| 用途 | 典型内容 | 收件人规则 |
|---|---|---|
TRANSACTIONAL | 验证码、订单、账单和服务通知 | 支持多个 To、Cc 和 Bcc；归一化去重后总计最多 100 个收件人。 |
MARKETING | 推广、活动和订阅资讯 | 原始请求必须恰好一个 To，Cc 和 Bcc 必须为空。 |
非模板邮件省略 时默认为 。不要把营销内容标记为事务邮件以绕过收件人或退订规则。
最后更新于