Tovanix
邮件发送 API
用你自己的域名从服务端发信,与控制台里的「邮件发送」共用同一套配额、计费与限制。发件地址的域名必须与已接入且已生效的发信域名完全一致。
- 鉴权:与平台其它开放 API 共用同一把用户级密钥
- 发送邮件:POST /api/v1/mail/send,响应按收件人分组返回投递结果,bounced_addrs 是清理名单的唯一依据
- 幂等键:带 Idempotency-Key 时同一个键重复提交只发送一次,避免重复送达与重复计费
- 会话线程:带上 in_reply_to 与整条 references 链,回复才会并入对方原会话
- 配额与域名:查询今日余量与可用发信域名,便于在自己系统里限速
- 代码示例:cURL / Node.js / Python / Go / PHP 最小可用示例,均含幂等键与硬退信处理
常见问题
HTTP 200 是不是代表全部送达?
不是。响应按收件人分组,一封发给 5 个人的信可能是 2 个送达、1 个排队、2 个硬退;平台没有退信回调,bounced_addrs 字段是你清理名单的唯一依据,应立即停止向这些地址再投。
什么时候必须带 Idempotency-Key?
只要你的调用会自动重试(超时重试、任务队列重投、SDK 内置重试)就必须带。没有它,一次网络抖动就等于收件人收到两封并计两次费,而这两件事都无法回滚;建议用订单号这类业务主键。
相关页面: Tovanix API 文档 · SMTP 聚合 API · SMTP 聚合 API 使用指南
正在加载…