5 分钟用 Rovela 发出第一封邮件

Rovela 是面向开发者的邮件平台。你只需调用一个 HTTP 端点，我们负责投递、追踪和合规。本指南帮你在 5 分钟内完成集成并发出第一封邮件。

前提条件

• 一个你拥有控制权的域名（例如 acme.com）
• 在 rovela.dev 注册的账号

第一步：创建 API Key

登录后，进入 Settings → API Keys，点击 New Key。复制密钥——它只展示一次。

第二步：验证发信域名

进入 Domains → Add domain，填入你的域名。Rovela 会生成三条 DNS 记录：

类型	名称	值
TXT	_rovela.acme.com	所有权证明
TXT	rovela._domainkey.acme.com	DKIM 公钥
TXT	_dmarc.acme.com	DMARC 策略

在你的 DNS 服务商处添加这些记录，然后点击 Verify。记录生效后 DKIM 签名自动启用。

第三步：发送第一封邮件

curl -X POST https://api.rovela.dev/v1/emails \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "you@acme.com",
    "to":   ["user@example.com"],
    "subject": "来自 Rovela 的问好",
    "text": "这封邮件通过 Rovela API 发送。",
    "html": "<p>这封邮件通过 <strong>Rovela API</strong> 发送。</p>"
  }'

成功响应示例：

{
  "id": "msg_01jx4...",
  "status": "queued"
}

第四步：追踪投递状态

每封邮件都有唯一 ID。轮询 GET /v1/emails/{id} 或订阅 Webhook，实时获取投递、打开和点击事件。

curl https://api.rovela.dev/v1/emails/msg_01jx4... \
  -H "Authorization: Bearer YOUR_API_KEY"

下一步

• 模板 — 存储带变量占位符的可复用 HTML
• Webhook — 将投递事件推送到你自己的端点
• 抑制列表 — 自动遵守退订请求

完整 API 文档 涵盖所有字段和响应码。