REST API

一次 JSON 请求即可发送。幂等键可防止重复投递。

开始使用文档

核心资源

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

响应模型

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

当前访问模式

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

集成资源

人类和 AI 代理可使用分步指南；字段级事实以 OpenAPI 为准。

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