發信 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 金鑰 看常見問題