共享Resend作品集
为多个产品通过单个Resend账户和已验证域名实现邮件发送功能。面向独立开发者或小型项目组合,优化免费层级的资源利用率,避免每个应用看起来像同一产品。
核心模型
共享基础设施,而非产品身份:
一个Resend账户
└── 已验证的发件域名
├── 产品A发件身份
├── 产品B发件身份
└── 产品C发件身份
每个应用保持独立的:
- 发件显示名称
- 目标收件箱
- 回复路由
- 主题约定
- 品牌HTML和纯文本模板
- 部署环境变量
- 投递日志和失败处理
所有应用共享账户级别的免费层配额和已验证域名的信誉。
作品集发现
在实现之前:
- 检查目标应用以及任何已有Resend配置的同组应用。
- 确定规范的Resend账户和已验证域名。
- 确认产品显示名称、共享发件邮箱、内部收件人、支持回复收件箱以及预期的邮件类型。
- 确认目标部署是否已存在Resend API密钥。
- 除非现有账户无法满足明确的要求,否则不要要求用户创建新账户、验证新域名或购买套餐。
账户和密钥策略
复用同一个Resend账户和已验证域名。当账户允许时,优先为每个已部署的应用使用独立的API密钥;这可将泄露或轮换密钥的影响限制在单个应用上,同时保持在一个账户和配额下。仅在无法获得独立密钥或用户明确倾向于这种权衡时,才复用同一个密钥。
切勿将另一个存储库中的密钥复制到源码中。将选定的密钥直接添加到每个部署的环境变量中。
每产品配置
在可行的情况下,使用服务器端变量和产品特定的名称。从用户现有的Resend账户、已验证发件配置和预期产品收件箱中解析这些变量的值——切勿将示例身份复制到实现中。
| 变量角色 | 用途 |
|---|---|
| Resend API密钥 | 认证服务器端提供者调用 |
| 产品发件身份 | 将当前产品的显示名称与已验证域名上的地址组合 |
| 产品联系收件人 | 接收该产品的内部通知 |
| 产品回复地址 | 在联系人收件人之外,接收用户消息的回复 |
可见的显示名称提供产品身份;已有的已验证地址确保投递能力。切勿使用 NEXT_PUBLIC_ 或类似客户端暴露的变量存储API密钥。
联系表单路由
发送两条独立的消息:
内部通知
发件人:配置的产品发件身份
收件人:配置的内部产品收件箱
回复地址:访客提交的已验证地址
访客确认
发件人:配置的产品发件身份
收件人:访客提交的已验证地址
回复地址:配置的内部产品收件箱
不要将访客和内部收件箱放在同一个收件人列表中。独立的消息可避免地址暴露,并允许不同的内容。
将内部通知视为主要投递。仅当Resend接受内部通知并返回消息ID后,才返回表单提交成功。随后尝试发送访客确认;记录其失败,但不要声称主要查询丢失。
品牌隔离
为每个产品创建独特的模板外壳,同时保持提供者模块模式可复用。自定义:
- 产品名称和描述符
- 颜色、排版和页眉处理
- 邮件预览文本
- 主题和语气
- 页脚所有权、支持地址和回复期望
使用表格布局、内联CSS、600–640px内容宽度、转义的用户值以及纯文本版本。不要仅因为发件基础设施是共享的,就复用另一个产品的视觉身份。
共享免费层保护措施
- 检查当前的Resend免费层限制,而不是依赖记忆中的数字。
- 记住每个应用都消耗同一个账户的配额。
- 仅发送必要的事务性消息;避免重复的通知。
- 保持公共表单的反垃圾控制:验证、长度限制、蜜罐以及适当情况下的限速。
- 避免可能发送重复的循环重试。在存在有意义的重试风险的工作流中,使用持久化或幂等性。
- 监控提供者拒绝和配额错误,但不记录敏感信息或不必要的个人数据。
- 仅在实测量、隔离性、合规性或信誉要求证明合理时,才升级到另一个账户或付费计划。
可靠实现
- 在正确的工作区中安装官方的
resend包。 - 将提供者调用放在服务器端模块中。
- 验证
result.data?.id且result.error不存在。 - 捕获SDK和网络异常。
- 显式设置
replyTo。 - 当邮件未配置时返回
503,当主要投递失败时返回502。 - 在UI中保留直接的电子邮件、电话或消息备用方案。
- 切勿将仅日志处理报告为成功投递。
验证
- 确认在复用的Resend账户中已验证共享域名。
- 确认产品特定的发件人、收件人和回复地址值。
- 测试内部投递,然后测试访客确认,再测试双向回复。
- 测试验证、蜜罐、缺少密钥、提供者拒绝和备用路径。
- 运行存储库原生的类型检查、lint、测试和构建命令。
- 确认部署包含其API密钥和产品变量。
- 在声明实时投递有效之前,执行一次真实的提交。