用途:在应用中集成 Resend 事务性邮件服务,用于发送魔法链接、定时邮件,并支持取消与查询已发送邮件。
主要能力:支持 SMTP 与 REST API 两种方式。SMTP 适合简单发送;HTTP API 支持定时发送(scheduled_at,仅 HTTP API 可用)、取消定时邮件和列出邮件。scheduled_at 接受 RFC3339(如 2026-05-16T00:18:20Z)或自然语言(如 in 1 min)。
密钥与权限:Resend 使用分范围 API 密钥。仅发送密钥(re_...)可发送和定时发送,但不能取消或列出;完全访问密钥可发送、定时、取消、列出。建议用仅发送密钥做常规发送,另用完全访问密钥做取消与列出等管理操作。
使用方式:SMTP 配置为 SMTP_HOST=smtp.resend.com、SMTP_PORT=587、SMTP_USER=resend、SMTP_PASS=re_your_api_key,SMTP 用户固定为字符串 resend。HTTP API 发送示例:curl -X POST https://api.resend.com/emails -H "Authorization: Bearer re_your_api_key" -H "Content-Type: application/json",返回邮件 id。取消需完全访问密钥:curl -X POST https://api.resend.com/emails/{id}/cancel。列出:curl -X GET 'https://api.resend.com/emails?limit=100',limit 取 1-100,默认 20,支持 after/before 分页。可在 Go 中用接口抽象 ConsoleSender(开发)与 SMTPSender(生产),按是否设置 SMTP_HOST 切换。
限制:发送前域名须在 Resend 验证并配置 DNS 记录,from 地址须用已验证域名,否则返回 550;仅发送密钥执行取消或列出会返回 401;定时邮件不可修改,只能取消后重建;每封邮件最多 50 个收件人,批量需多次发送。未验证自有域名时可使用其他项目已验证的域名,但 SMTP_FROM 须使用该域名。