建立最小權限 API Key
在 Dashboard 接受目前政策並建立 Sending Access Key,只放在伺服器環境變數,不放進瀏覽器程式碼。
FORWARD_API_KEY先用 10 分鐘證明 Email、Log 與 Webhook 生命週期,再連接真實信箱與寄件網域。說明採繁中;API 欄位、套件名稱、錯誤碼與程式碼介面保留英文,方便直接複製整合。
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);四個步驟把測試、真實信箱、網域與正式流量分開,避免第一次整合就把客戶當測試資料。
在 Dashboard 接受目前政策並建立 Sending Access Key,只放在伺服器環境變數,不放進瀏覽器程式碼。
FORWARD_API_KEY先寄到 delivered@forward.test。這會建立真實 Forward ID、Log 與簽章 Webhook Event,但不會呼叫寄送供應商。
不消耗寄送額度從 Launch Center 寄一封固定內容,只能送到已登入的 Workspace 成員 Email,證明平台寄件路徑可達。
收件人不可任意更換完成 Forward 所有權 TXT、供應商 SPF 與 DKIM,確認 Event Trail 後再申請正式寄送權限。
Sandbox → Production正式寄送仍需已驗證網域、Workspace 審核與健康的寄送供應商;Sandbox 測試永遠不會偷跑成正式流量。
先找到正在做的工作,再進入對應的完整技術邊界、Endpoint、SDK 方法與錯誤處理。
REST API、TypeScript/Python/Go SDK、CLI 與 SMTP 全部走同一套安全、額度與寄送紀錄。
用 Template、Event、Automation、Audience 與 Broadcast 共用內容、分眾、偏好與成效。
網域、Webhook、Suppression、寄件信譽與用量都能從 Dashboard、API 與通知中追蹤。
啟用 Inbound Email 後,收信、附件、回覆與轉寄仍遵守 Workspace、內容保留與寄送安全。
官方 TypeScript、Python 與 Go SDK、CLI、SMTP 和 MCP 都從同一份 OpenAPI 3.1 契約出發。成功結果保留 Request ID、Rate Limit 與 Quota Metadata;寫入操作不會在背後偷偷重試。
移轉橋接會清楚告訴你哪些可以直接沿用、哪些要重建一次,以及 Suppression、Domain Claim 與 Webhook Secret 不能省略的安全步驟。