已验证域名的 Email API（2026）：用 Rovela 从自己的域名发信

Rovela 会以 400 拒绝未验证的 from 地址。添加 DNS（SPF、DKIM、DMARC、return-path），验证发信域名，必要时限制 API Key，然后调用 POST /emails。

已验证域名的 Email API：用你自己的域名发信

已验证域名的 Email API 是这样一种 HTTP 发信接口：在你证明自己控制该域名之前，它不会接受相应的 from 地址。在 Rovela 里，这个证明就是 Dashboard 出示的 DNS 记录。从未验证域名发出的请求会被 400 拒绝，而不是先受理再悄悄丢掉（快速开始）。

这是「通过 API 用我的域名发信」这一产品查询，而不是 SPF/DKIM/DMARC 教科书。认证原理见邮件认证如何工作、事务邮件的 DKIM 设置和域名设置指南。「什么是域名邮箱」见什么是邮箱域名？和如何设置域名邮箱。

可以从Email API产品页、快速开始、发送邮件 API和身份认证入手。另见域名 API和域名手册。

本系列相关产品指南：

为什么 API 要坚持验证

从 no-reply@yourproduct.com 发出的事务邮件，只有在接收方能检查该邮件与这个域名对齐时才有效。Rovela 会用你的域名密钥为每封出站邮件做 DKIM 签名，并完成 SPF 对齐（Email API，事务邮件）。在记录生效并且你点击 Verify 之前，这件事没有诚实的做法，所以 API 会在请求进入时就失败。

快速开始列出了四种职责不同的记录：

SPF — 哪些服务器可以为该域名发信
DKIM — 为邮件签名，接收方可以判断它未被篡改
DMARC — 前两项失败时，接收方应如何处理
Return-path — 让 Rovela 能替你接收退信

DNS 传播需要时间。刚发布就失败，通常表示「还没到」，而不是「写错了」——先等几分钟再复查，不要急着改记录（快速开始）。

按定价，用于 SPF 对齐的自定义 return path 包含在 Pro 和 Enterprise，免费计划不含。请以 Dashboard 和域名指南里，针对你的计划和域名实际出示的记录为准。

从验证域名到第一次 API 发送

在 Domains（Dashboard）中添加域名，或用 full_access / session 调用域名 API。
原样发布出示的记录。指南和手册会讲解验证和 DKIM 轮换。
记录生效后点击 Verify（或等价的 API 调用）。
创建 sending_access API Key。Key 还可以限制在单个域名——适合你在一个组织里替多个客户发信，这样泄露的 Key 不能冒充别人发信（身份认证）。
使用该域名上的 from 调用 POST /emails：

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."
  }'

如果域名不对，或不属于你的组织，你会得到指出该域名的 400。这就是已验证域名 Email API 的实际形态：HTTP 调用很简单，域名是那道门。

同一域名上的邮箱 SMTP 和 webmail 是域名存在之后的另一套界面（事务邮件 API + 托管邮箱）。入站 MX 是又一项可选变更（入站与出站 Email API）。

验证之后如何运维这个域名

子域。 许多团队从 mail.example.com 或 alerts.example.com 发送事务邮件，以隔离信誉（可参考已有的发信子域设置）。请验证你真正写在 from 里的那个子域。
Key 范围。 一个组织有多个品牌时，生产发信应尽量使用受域名限制的 sending_access。
轮换。 DKIM 轮换是 Dashboard / 手册里的操作；API Key 轮换是 create-then-revoke。
Webhook。 事件目录里有 domain.created、domain.updated、domain.deleted。删除之后，从该域名发送会被拒绝（事件）。
跟踪。 打开和点击事件只在该发信域名开启跟踪时才会触发。

不要在这里编造额外的记录或独立 IP。使用 Rovela 出示的记录，以及定价上列出的功能。

FAQ

能用 API 以 Gmail 或公共邮箱服务的地址作为 from 吗？ 不能。地址必须位于你在 Rovela 已验证的域名上。

我们已经为 Google Workspace 配过 SPF。 你仍然要发布 Rovela 为该发信域名（或专用发信子域）生成的记录。不要猜测一条合并后的记录——按域名指南操作，以免影响现有邮件。

验证会过期吗？ 以 Dashboard 状态为准；若 DNS 被改掉或删除，请重新验证。快速开始的建议是：在改写记录之前，先复查传播情况。

验证域名等于创建邮箱吗？ 不等于。验证解锁的是发信（也是入站的前提）。邮箱是你另外添加的托管收件箱。

先验证，再 POST

Email API 不会假装未验证的 from 没有问题。添加域名、发布记录、完成验证，再用一把不能跑到别人域名上的 Key 发送。这就是已验证域名 Email API 要做的事。