简单的事务邮件 API(2026):用 Rovela 的 HTTP + JSON,不必自建邮件服务器
简单的事务邮件 API 仍然要求你做什么(已验证域名、sending_access、POST /emails),以及可以停止拼装什么——不编造文档里没有的功能。
简单的事务邮件 API:HTTP + JSON,不必自建邮件服务器
简单的事务邮件 API 让你用一次 HTTPS 请求,把产品本来就该发给用户的信——验证码、收据、重置——发出去,而不必自己架 MTA、梳理一整张 IAM 关系图,或安装官方 SDK。Rovela 的做法在文档里就是 https://api.rovela.dev 上的纯 HTTP 与 JSON:没有要安装的客户端库(安装说明,Email API)。
本文把这种「简单」当作一种产品选择:你仍然要做哪些事,以及可以停止拼哪些东西。这不是一篇拆竞品的文章——若你正从 Amazon SES 迁出,请看Amazon SES 替代方案:简单 HTTP API和Rovela 与 Amazon SES,不必在这里重复那些对比。自建的取舍见自建邮件服务器。协议对比见Email API 与 SMTP 对比。
可以从Email API产品页、快速开始、发送邮件 API和身份认证入手。
本系列相关产品指南:
- 事务邮件 API
- HTTP 邮件 API
- 从 SMTP 迁到 Email API
- SaaS 应用的 Email API
- 用 curl 发送邮件
- 事务邮件 API + 托管邮箱
- 入站与出站 Email API
- 邮件发送 API
- 邮件通知 API
- Email API 集成
- 批量事务邮件 API
- 事务邮件 Webhook
- 从应用发送事务邮件
- 已验证域名的 Email API
「简单」仍然要求你做的
简单不等于「不用 DNS」。你仍然要:
- 注册账号(免费计划发送的是真信;没有另一套测试 Key)(快速开始)。
- 验证发信域名——SPF、DKIM、DMARC、return-path。未验证的
from会400。 - 创建
sending_accessKey,并只放在服务端(身份认证)。 - 用 JSON 调用
POST /emails。按需加上Idempotency-Key、webhook、批量、模板。
热路径就是这些。你不必安装 Rovela SDK,不必跑邮件守护进程,也不必从 VPC 打开 25 端口。任何能发 HTTPS 请求的语言都可以——产品页把 curl、Python、Go、Ruby、Java、Node、PHP 列为例子,而不是必装的包。
curl -X POST https://api.rovela.dev/emails \
-H "Authorization: Bearer re_your_sending_key" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: verify-signup-8f3a2c" \
-d '{
"from": "Acme <no-reply@yourdomain.com>",
"to": "alice@example.com",
"subject": "Your Acme code: 482913",
"html": "<p>Your verification code is</p><p style=\"font-size:28px;letter-spacing:6px\"><b>482913</b></p><p>It expires in 10 minutes.</p>",
"text": "Your verification code is 482913. It expires in 10 minutes."
}'
你可以停止拼装的
团队常常最终要拼:发送 API 或 SES、退信主题、密钥策略、模板仓库、一台 cron,再外加一套 Workspace 来放 support@。简单的 API 不会神奇地包含所有周边工具,但 Rovela 把下面这些写在同一个产品里(只在你需要时使用):
- 投递 webhook 和按消息的日志(事务邮件 Webhook)
POST /emails/batch和scheduled_at(批量事务邮件 API,定时发送邮件)- 已存储模板(邮件模板 API 指南)
- 托管邮箱和 webmail(事务邮件 API + 托管邮箱)
- 入站(入站与出站 Email API)
定价按计划限额,而不是按联系人名单给你意外:免费计划含每月 100 封、完整 API、入站、webhook 和 5 个邮箱,无需绑卡(定价)。我们不宣称有独立 IP、SLA 或官方 SDK——本文所依据的产品页没有列出这些。按价目表,自定义 return path 是 Pro / Enterprise 功能。
简单不等于随便
- 仍然要验证域名并对齐认证(已验证域名的 Email API,事务邮件的 DKIM 设置)。
- 仍然要在会重试的用户动作上使用幂等(邮件 API 的幂等键)。
- 仍然不能把 Key 放进客户端(Email API 集成)。
- 仍然要把
200当作已入队,而不是已投递。 - 仍然要把营销名单走广播,而不是把「简单的 POST」紧循环(营销邮件)。
若应用已经在说 SMTP,又想走这条更简单的 HTTP 路径,切换指南是从 SMTP 迁到 Email API。
FAQ
「没有 SDK」是缺陷吗? 对大多数后端来说这是优点:一套 HTTP 契约,没有库的版本滞后。若你想要可粘贴的客户端,已经有各语言走读。
我能自己运行 Rovela 吗? 安装页同时写了托管使用,以及自行运行的要求。本文默认你用托管 API。
这只适合小项目吗? 同一套 API 在每个计划里都有。计划的差别是能发送和存储多少,而不是有没有 batch、模板或 webhook(定价)。
让请求保持很小
验证一个域名,把 sending_access 放在服务端,向 /emails POST JSON。这就是简单的事务邮件 API——也足够支撑本系列其余文章。