发信 API 文档

用一个 API 给你的网站发注册验证、找回密码、营销通知邮件 —— 不用自己搭 SMTP。

去拿 API 密钥

现已可用 域名所有权、MX / SPF / DKIM / DMARC 会分别校验;全部通过后即可用密钥发信,并在控制台查看按收件人的成功、失败与处理中统计。

快速开始

  1. 1

    绑定域名

    在「网站发信」添加你的发信域名。

  2. 2

    校验 DNS

    按提示添加 SPF / DKIM / DMARC 与验证 TXT 记录,一键校验通过。

  3. 3

    生成密钥

    创建 te_live_ 密钥,明文只显示一次,请当场保存。

发送一封邮件

POST 请求,Authorization 头带上你的 te_live_ 密钥。

curl -X POST https://tutuemail.com/api/sending/send \
  -H "Authorization: Bearer te_live_xxxxxxxxxxxxxxxx" \
  -H "Idempotency-Key: signup-user-123" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "noreply@your-domain.com",
    "to": "user@example.com",
    "subject": "欢迎注册",
    "html": "<p>点击验证你的邮箱</p>"
  }'

请求字段

from 发件地址,须为已校验域名下的地址
to 收件地址(单个或数组)
subject 邮件主题
html / text 邮件正文(HTML 或纯文本)
Idempotency-Key 可选请求头;重试使用同一个值,避免重复发信

成功接受返回 HTTP 202、请求 id 与 accepted 状态。用同一 API 密钥 GET /api/sending/messages/{id} 查询每个收件人的送达、失败、处理中或结果未知状态。

错误码与限制

401 密钥无效或已吊销 —— 重新生成 te_live_ 密钥
403 发件域名未校验,或地址不在已校验域名下
429 超出发信速率,响应带 retry_after,按提示稍后重试
503 邮件引擎暂不可用;保持相同 Idempotency-Key 退避重试

收件人数、正文大小与速率均有保护上限;校验通过后才计数,非法请求不空耗你的配额。

准备好接入了?

去拿 API 密钥 看常见问题