产品

REST API

一个 JSON 请求即可发送。

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

身份认证

以 Bearer 令牌形式发送控制台签发的受限 srs_live_ 密钥。每个密钥有独立的 scope（emails:send、webhooks:write …）；已撤销或过期的密钥返回 401。

核心资源

POST /v1/emails — 将一封邮件加入队列
POST /v1/emails/batch — 单次请求最多 100 封邮件
GET /v1/emails — 列出最近的邮件
GET /v1/emails/{id} — 邮件状态
DELETE /v1/emails/{id}/schedule — 取消定时发送

响应模型

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 接收不保证成功投递或进入收件箱。