Tovanix
郵件寄送 API
用你自己的網域從伺服器端寄信,與主控台裡的「郵件寄送」共用同一套配額、計費與限制。寄件位址的網域必須與已接入且已生效的寄信網域完全一致。
- 驗證:與平台其他開放 API 共用同一把使用者層級金鑰
- 寄送郵件:POST /api/v1/mail/send,回應依收件者分組回傳投遞結果,bounced_addrs 是清理名單的唯一依據
- 冪等鍵:帶 Idempotency-Key 時同一個鍵重複提交只寄送一次,避免重複送達與重複計費
- 對話串:帶上 in_reply_to 與整條 references 鏈,回覆才會併入對方原對話
- 配額與網域:查詢今日餘量與可用寄信網域,便於在自己的系統裡限速
- 程式範例:cURL / Node.js / Python / Go / PHP 最小可用範例,皆含冪等鍵與硬退信處理
常見問題
HTTP 200 是不是代表全部送達?
不是。回應依收件者分組,一封寄給 5 個人的信可能是 2 個送達、1 個排隊、2 個硬退;平台沒有退信回呼,bounced_addrs 欄位是你清理名單的唯一依據,應立即停止再寄給這些位址。
什麼時候必須帶 Idempotency-Key?
只要你的呼叫會自動重試(逾時重試、任務佇列重送、SDK 內建重試)就必須帶。沒有它,一次網路抖動就等於收件者收到兩封並計兩次費,而這兩件事都無法復原;建議用訂單編號這類業務主鍵。
相關頁面: Tovanix API 文件 · SMTP 聚合 API · SMTP 聚合 API 使用指南
正在載入…