发送邮件

邮件内容

请提供一个位于工作区已验证域名上的 from 发信身份、至少一个 to 收件人，以及 HTML、纯文本或一个已发布的托管模板。直接提供内容的发送可以省略 subject，此时主题为空。必要时 SendHQ 会根据 HTML 生成纯文本版本，但您自己编写的纯文本版本更可靠。

收件人与额度

一封邮件的 To、Cc 和 Bcc 目标地址合计最多 100 个。每个目标地址消耗一个收件人投递额度。规范化后重复的收件人地址只做一次抑制检查，但每个目标地址仍会计入邮件限制。

安全重试

在单封和批量提交时，请发送一个稳定的 Idempotency-Key，长度不超过 200 个字符。使用相同的 key 和完全相同的 JSON 请求体重复请求时，会重放已存储的响应，并附加 Idempotent-Replayed: true。在同一个 key 下更改任何收件人、内容、邮件头或模板数据都会返回 409；在第一个请求仍在处理中时，使用该 key 的并发请求同样会返回 409。

批量发送

POST /emails/batch 最多接受 100 个邮件对象，并为每个位置返回一个结果。对于个性化的模板数据，请使用各自独立的邮件对象，而不是将一个个性化模板发送给多个收件人。

回复与会话

回复时请设置 reply_to_email_id。SendHQ 会推导出 Message-ID、In-Reply-To、References 以及已有的会话 ID。使用 GET /threads/:id 获取完整的会话。

状态模型