邮件基础设施指南
如何通过 API 发送邮件
逐步讲解如何通过 API 发送经过身份验证的邮件，以及如何测试并确保生产环境安全。
一个生产环境的邮件请求，需要的不只是收件人和主题。它还需要已验证的发件人、与用途相符的模板、身份验证、错误处理，以及观察发送结果的途径。
实际意味着什么
- 已验证的 From 域名
- 限定到正确工作区的 API 密钥
- 结构化的 HTML 和纯文本内容
- 避免重复投递的重试策略
实施检查清单
- 创建已验证域名并选择发件地址。
- 将 API 密钥保存在服务器端的环境变量中。
- 向一个受控的收件箱发送测试邮件。
- 记录服务商返回的响应 ID，并处理非成功的响应。
- 为需要重试的任务添加幂等键或事件 ID。
团队常问的问题
可以在浏览器代码中使用 API 密钥吗？
不可以。请把发信凭据保存在服务器、工作进程或受信任的后端中。
如何避免重复发送邮件？
使用稳定的事件标识符或幂等键，并在重试失败任务之前持久化服务商返回的邮件 ID。