REST API

一个 JSON 请求即可发送。

核心资源

POST /v1/emails — 将邮件加入队列 GET /v1/emails/{id} — 查询邮件状态

响应模型

202 表示已进入队列，而非已送达收件箱。403 可能表示缺少 scope 或域名尚未验证。422 会阻止发送给已抑制的收件人。429 表示触发了速率限制。

当前服务限制

REST API 不支持附件。自定义标头仅允许 In-Reply-To、References、List-Unsubscribe 和 List-Unsubscribe-Post（最多 8 个）。托管邮箱独立运行：网页客户端支持最多 20 个附件、合计 25 MiB；已发布的桌面客户端发送上限为 10 MiB。HTTP 202 和 email.accepted 表示已接收处理；SMTP 接收不保证成功投递或进入收件箱。

当前访问模式

当前密钥使用 srs_live_。验证客户 From 域之前，共享 sandbox 发件人只能发送给项目成员。验证后仍受套餐配额、抑制列表、收件人限流和滥用控制约束。202 表示已排队，而非已送达。

POST /v1/emails

POST /v1/emails
Authorization: Bearer srs_live_...
Idempotency-Key: reset-4821
Content-Type: application/json

{
  "from": "Sender Name <info@example.com>",
  "to": ["user@example.net"],
  "subject": "Reset your password",
  "html": "<p>Click to reset your password.</p>"
}