台灣繁中開發導讀

從第一封測試信,到正式上線,每一步都說人話。

先用 10 分鐘證明 Email、Log 與 Webhook 生命週期,再連接真實信箱與寄件網域。說明採繁中;API 欄位、套件名稱、錯誤碼與程式碼介面保留英文,方便直接複製整合。

不接觸寄送供應商 不消耗寄送額度 保留完整 Log 與 Webhook
first-forward-email.ts
const response = await fetch(
  `${process.env.FORWARD_BASE_URL}/api/v1/emails`,
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.FORWARD_API_KEY}`,
      "Content-Type": "application/json",
      "Idempotency-Key": "first-test-v1"
    },
    body: JSON.stringify({
      from: "Forward <sandbox@forward.test>",
      to: "delivered@forward.test",
      subject: "我的第一封 Forward 測試信 ✨",
      text: "這封信不會離開 Forward。"
    })
  }
);

const email = await response.json();
console.log(email.id, email.status, email.test_mode);
安全的第一步test_mode: true
10 分鐘 Quickstart

先證明生命週期,再碰正式收件人。

四個步驟把測試、真實信箱、網域與正式流量分開,避免第一次整合就把客戶當測試資料。

01

建立最小權限 API Key

在 Dashboard 接受目前政策並建立 Sending Access Key,只放在伺服器環境變數,不放進瀏覽器程式碼。

FORWARD_API_KEY
02

寄到保留測試地址

先寄到 delivered@forward.test。這會建立真實 Forward ID、Log 與簽章 Webhook Event,但不會呼叫寄送供應商。

不消耗寄送額度
03

確認私人真實信箱

從 Launch Center 寄一封固定內容,只能送到已登入的 Workspace 成員 Email,證明平台寄件路徑可達。

收件人不可任意更換
04

驗證網域,再切正式流量

完成 Forward 所有權 TXT、供應商 SPF 與 DKIM,確認 Event Trail 後再申請正式寄送權限。

Sandbox → Production
付費不會略過安全檢查。

正式寄送仍需已驗證網域、Workspace 審核與健康的寄送供應商;Sandbox 測試永遠不會偷跑成正式流量。

閱讀完整 Quickstart
按工作選指南

不用從 1,000 行文件開始讀。

先找到正在做的工作,再進入對應的完整技術邊界、Endpoint、SDK 方法與錯誤處理。

寄信與整合

選你熟悉的方式接上 Forward

REST API、TypeScript/Python/Go SDK、CLI 與 SMTP 全部走同一套安全、額度與寄送紀錄。

內容與旅程

把通知、培養與活動信接成旅程

用 Template、Event、Automation、Audience 與 Broadcast 共用內容、分眾、偏好與成效。

營運與安全

正式流量上線前,把邊界逐一確認

網域、Webhook、Suppression、寄件信譽與用量都能從 Dashboard、API 與通知中追蹤。

一份 API 契約,多種整合方式

工具可以不同,安全邊界不能漂移。

官方 TypeScript、Python 與 Go SDK、CLI、SMTP 和 MCP 都從同一份 OpenAPI 3.1 契約出發。成功結果保留 Request ID、Rate Limit 與 Quota Metadata;寫入操作不會在背後偷偷重試。

已經在用 Resend?

先保留熟悉的寄送呼叫,再慢慢換成完整 Forward。

移轉橋接會清楚告訴你哪些可以直接沿用、哪些要重建一次,以及 Suppression、Domain Claim 與 Webhook Secret 不能省略的安全步驟。