用途:面向使用 Resend 邮件 API 的开发者,指导发送事务邮件(单封或批量)、通过 Webhook 接收入站邮件,以及管理模板、域名、联系人、广播、自动化、API 密钥和日志等。
主要能力:单封发送支持附件与定时;批量发送支持 2-100 封不同邮件,但不支持附件与定时,且为原子操作,一封校验失败整批失败。幂等键可防止重试导致重复发送,格式为 <event-type>/<entity-id>,批量用 batch-<event-type>/<batch-id>,有效期 24 小时,最长 256 字符;同键同载荷返回原响应,同键不同载荷返回 409。入站邮件通过 Webhook 接收,需用 resend.webhooks.verify() 校验签名,载荷仅含元数据,正文需调用 resend.emails.receiving.get() 获取。
使用方式:API 密钥存于环境变量 RESEND_API_KEY,切勿硬编码。Node.js SDK 不抛异常,返回 { data, error },需显式检查 error。安装最新 SDK:Node.js 用 npm install resend(>=6.9.2),Python 用 pip install resend(>=2.21.0),Go 用 go get github.com/resend/resend-go/v3(>=3.1.0),Ruby 用 gem install resend(>=1.0.0),PHP 用 composer require resend/resend-php(>=1.1.0),Rust 用 cargo add resend-rs(>=0.20.0),Java 与 .NET 见安装文档。
适用场景:事务邮件通知、自动回复与转发、营销广播、事件驱动自动化等。
限制:API 不支持 CORS,必须服务端调用;测试用 delivered@resend.dev 等地址,勿用真实邮箱假地址;模板须先发布;html 与 template 互斥;批量不支持附件与定时;新域名需逐步预热;发送类密钥不能用于非发送端点。