从这里开始

从 Resend 迁移

将 Resend 的 HTTP 发信请求映射到 SendHQ，并在切换之前处理好兼容性边界。

兼容性边界

SendHQ 接受直接 HTTP 发信请求中常见的 Resend 风格 JSON 字段，但它并不能直接替换 Resend SDK。请将您自己的服务端 HTTP 适配器指向 /api/v1/emails；不要以为一个硬编码了 Resend 主机的 SDK 可以重新配置。

字段映射

from、to、cc、bcc、subject、html、text、reply_to 以及安全的自定义 headers 可以直接映射。SendHQ 还接受 message_class、托管 template 引用、draft_id 以及回复/会话字段。Resend 特有的 React 负载、内联附件数组、标签、受众、广播和定时发送字段没有可接受的对应项。

附件与模板

先将附件上传到 SendHQ 草稿，再使用 draft_id 发送。托管模板是 SendHQ 的资源，具有已发布的版本和带类型的数据；请显式迁移模板 ID 和渲染调用，而不是照搬某个服务商的模板标识符。

重试

为每一次逻辑上的发送生成一个稳定的 Idempotency-Key。使用该键重试完全相同的 JSON 负载。如果主题、正文、收件人、邮件头或模板数据发生变化，请使用新的键；否则 SendHQ 会返回 409。重放的已存储响应会包含 Idempotent-Replayed: true。

切换清单

  1. 验证您将要使用的每一个 From 域名和具体的发件地址。
  2. 向您自己的收件箱发送受控的纯文本和 HTML 邮件。
  3. 将服务商受理与投递事件分开确认。
  4. 演练对 409、422、423、429 和 5xx 的处理。
  5. 在事务性邮件和生命周期邮件两条路径都验证通过之前，保留之前的服务商适配器。