兼容 Resend 的邮件 API：兼容性不包括哪些方面

API 兼容究竟意味着什么

For email developers, Resend-compatible mail APIs implement the same request and response schemas as the provider they replace. If you use a Resend-compatible API, you can change your base URL and API key in your environment variables and your POST /emails calls will still work. It covers the syntax of the payload, the HTTP status codes, and the structure of the JSON response. It does not cover your sender reputation, your DNS configuration, your IP warm up, or your billing structure.

作为负责事件队列的工程师，我见过不少团队以为“兼容”就等于一键迁移。并非如此。您迁移的是接口，而不是基础设施。

接口层：兼容覆盖的部分

当一家服务商宣称兼容 Resend 时，通常是指它照搬了核心发信端点。这样您就可以发送如下负载：

{ "from": "onboarding@example.com", "to": "user@gmail.com", "subject": "Welcome to the App", "html": "<strong>Hello!</strong>" }

如果 API 是兼容的，服务器会返回 200 OK 或 201 Created 以及一个邮件 ID。这是“简单”的部分，它让您不必重写集成逻辑或更换 SDK。对于构建 AI 智能体的团队来说，这种一致性至关重要。当智能体通过 MCP 服务器或 A2A 卡片触发邮件时，它们依赖可预测的结构来确认副作用（发送邮件）确实已经发生。

基础设施层：兼容不覆盖的部分

兼容性止步于 HTTP 层。API 受理请求之后发生的一切，都取决于具体的服务商。

1. DNS 与域名验证

您的 API 密钥并不携带域名授权。您不能只是换个 URL，就指望邮件通过身份验证。您必须在新服务商处重新验证域名，这需要在 DNS 中添加新的 SPF、DKIM 和 DMARC 记录。

如果忘了更新这些记录，您的邮件很可能被拒收或被标记为垃圾邮件，因为新服务商并未获得代表您发信的授权。在正式切换之前，您可以使用 SendHQ 邮件 DNS 检查工具确认记录已正确传播。

2. 发件人信誉与 IP 预热

信誉与发信 IP 和域名绑定。从一家服务商迁移到另一家，您往往会换到一组新的共享 IP。即使您的域名信誉很好，新的 IP 也可能是“冷”的，更糟的是，可能与不良发件人共享。

服务商受理（API 返回“OK”）不同于投递（收件服务器接受邮件），而投递又不同于收件箱送达（邮件进入主收件箱）。兼容性覆盖的是服务商受理，对投递和收件箱送达毫无帮助。

3. Webhook 与事件结构

发信 API 可能是兼容的，但 Webhook 事件（已送达、退信、投诉）往往并不兼容。如果您的系统依赖跟踪投递事件来触发后续逻辑，就必须审查新服务商的 Webhook 负载。一个系统中的 bounce 事件，在另一个系统中可能是 hard_bounce。

兼容的代价：价格现实

兼容让您可以货比三家、寻找更划算的价格，而无需承担完全重写的成本。不过，各家的定价模式差异极大。基于 2026 年 9 月的数据：

• Amazon SES：价格最激进。按量计费为每 1,000 封邮件 0.10 USD（Amazon SES 价格）。2026 年 7 月 21 日推出的新分级套餐包括 Essentials（每 1,000 封 0.16 USD）、Pro（每 1,000 封 0.22 USD，另加每个区域每月 105 USD）和 Enterprise（每 1,000 封 0.23 USD，另加每月 500 USD）。
• Resend：提供每月 3,000 封邮件的免费额度（每天上限 100 封）。Pro 套餐为每月 20 USD、含 50,000 封邮件，超出部分每 1,000 封 0.90 USD（Resend 价格）。
• Postmark：每月 15 USD、含 10,000 封邮件，超出部分每 1,000 封 1.80 至 1.20 USD（Postmark 价格）。
• Mailgun：每月 15 USD、含 10,000 封邮件，超出部分每 1,000 封 1.80 至 1.10 USD（Mailgun 价格）。
• SendGrid：免费版现已改为 60 天试用，Essentials 起价为每月 19.95 USD（SendGrid 价格）。

直观地说：发送 50,000 封邮件在 SES 按量计费下约为 5 USD，而在 Postmark 的套餐下约为 66 USD。API 兼容让这种成本优化成为可能，而无需投入一个月的工程工作量。

为可靠性和智能体而设计

当您把邮件视为外部副作用时，尤其是在使用 AI 智能体的情况下，必须为失败做好准备。API 返回 200 OK 并不意味着邮件已经到达用户。

幂等

如果智能体因超时而重试请求，同一封邮件就有可能被发送两次，这会带来糟糕的用户体验。您应在请求头中使用幂等键，确保同一请求即使被发送两次，服务商也只发出一封邮件。

审批工作流

不应让智能体不受限制地使用您的发送配额。请为大批量发送实现审批层。以下是一份针对智能体驱动邮件的简单清单：

1. 结构校验：负载是否符合兼容 API 的规范？
2. 速率限制：智能体是否超出了每日上限（例如 Resend 免费版每天 100 封的限制）？
3. 幂等：这笔具体的事务是否有唯一键？
4. 人工介入：这封邮件在调用 API 之前是否需要人工签核？

迁移清单

如果您要迁移到兼容 Resend 的服务商，请按以下顺序操作，以免投递崩盘：

• DNS 设置：配置 SPF、DKIM 和 DMARC。阅读我们的邮件身份验证指南，确保没有遗漏记录。
• 验证：使用工具确认 DNS 传播。
• 预热：若发送量很大，请逐步将流量从旧服务商转移到新服务商。不要在一小时内迁移 100% 的流量。
• Webhook 审核：将新服务商的事件类型映射到您的内部数据库架构。
• 错误处理：测试新服务商如何处理无效邮箱地址。它会返回 400，还是返回 202 并在之后产生退信事件？

权衡总结

特性 | 兼容是否覆盖？ | 需要的操作

请求负载 | 是 | 无（规范一致时）

响应格式 | 是 | 无（规范一致时）

域名身份验证 | 否 | 更新 DNS 记录

IP 信誉 | 否 | 预热期

价格/配额 | 否 | 查阅服务商价格页面

Webhook 事件 | 否 | 更新事件监听器

兼容是提升灵活性的工具，而不是改善送达率的魔杖。通过将接口与基础设施分离，您可以针对成本和性能进行优化，而不会被锁定在单一服务商的生态中。

如需一款隐私数据最小化、面向智能体、能简化这些基础设施的邮件 API，欢迎了解 SendHQ。