快速開始

本指南將幫助您在幾分鐘內使用 Zeabur Email 發送第一封郵件。

前提條件

在開始之前，您需要：

一個 Zeabur 帳號
在 Zeabur 控制台中啟用 Zeabur Email 服務
至少一個已驗證的寄件網域
一個 API 金鑰

步驟 1：建立 API 金鑰

登入 Zeabur 控制台

訪問 Zeabur Dashboard 並登入您的帳號。

進入 Zeabur Email 管理頁面

在控制台中找到 Zeabur Email 服務並進入管理頁面。

建立新的 API 金鑰

點擊「建立 API 金鑰」按鈕
選擇權限類型：
- 唯讀：僅能查詢郵件狀態
- 僅發送：可發送郵件和查詢狀態（建議用於生產環境）
- 完整權限：包含所有操作權限
可選：限制網域權限（只能使用特定網域發送）
點擊「建立」

⚠️

建立後請立即儲存 API 金鑰，金鑰僅顯示一次！

步驟 2：驗證網域

要發送郵件，您需要先驗證寄件網域：

新增網域

在 Zeabur Email 管理頁面的「網域管理」中，點擊「新增網域」。

設定 DNS 記錄

系統會產生 DKIM、SPF 和 DMARC 記錄，您需要在網域 DNS 提供商處新增這些記錄。

等待驗證

DNS 記錄新增後，點擊「驗證」按鈕。驗證通常需要幾分鐘到幾小時。

步驟 3：發送第一封郵件

網域驗證通過後，您就可以發送郵件了！

使用 cURL

curl -X POST https://api.zeabur.com/api/v1/zsend/emails \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "from": "[email protected]",
    "to": ["[email protected]"],
    "subject": "來自 Zeabur Email 的問候！",
    "html": "<h1>你好！</h1><p>這是我從 Zeabur Email 發送的第一封郵件。</p>",
    "text": "你好！這是我從 Zeabur Email 發送的第一封郵件。"
  }'

使用 JavaScript/Node.js

const response = await fetch('https://api.zeabur.com/api/v1/zsend/emails', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer YOUR_API_KEY'
  },
  body: JSON.stringify({
    from: '[email protected]',
    to: ['[email protected]'],
    subject: '來自 Zeabur Email 的問候！',
    html: '<h1>你好！</h1><p>這是我從 Zeabur Email 發送的第一封郵件。</p>',
    text: '你好！這是我從 Zeabur Email 發送的第一封郵件。'
  })
});
 
const data = await response.json();
console.log('郵件已發送:', data);

使用 Python

import requests
 
response = requests.post(
    'https://api.zeabur.com/api/v1/zsend/emails',
    headers={
        'Content-Type': 'application/json',
        'Authorization': 'Bearer YOUR_API_KEY'
    },
    json={
        'from': '[email protected]',
        'to': ['[email protected]'],
        'subject': '來自 Zeabur Email 的問候！',
        'html': '<h1>你好！</h1><p>這是我從 Zeabur Email 發送的第一封郵件。</p>',
        'text': '你好！這是我從 Zeabur Email 發送的第一封郵件。'
    }
)
 
print('郵件已發送:', response.json())

使用 Go

package main
 
import (
    "bytes"
    "encoding/json"
    "fmt"
    "net/http"
)
 
func main() {
    payload := map[string]interface{}{
        "from":    "[email protected]",
        "to":      []string{"[email protected]"},
        "subject": "來自 Zeabur Email 的問候！",
        "html":    "<h1>你好！</h1><p>這是我從 Zeabur Email 發送的第一封郵件。</p>",
        "text":    "你好！這是我從 Zeabur Email 發送的第一封郵件。",
    }
 
    jsonData, _ := json.Marshal(payload)
    req, _ := http.NewRequest("POST", "https://api.zeabur.com/api/v1/zsend/emails", bytes.NewBuffer(jsonData))
    req.Header.Set("Content-Type", "application/json")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
 
    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()
 
    fmt.Println("郵件已發送！狀態:", resp.Status)
}

回應範例

成功發送後，您會收到如下回應：

{
  "email_id": "696de2c84210d814d66ee052",
  "status": "queued",
  "message": "Email queued for sending"
}

下一步

現在您已經成功發送了第一封郵件！接下來可以：

查看 REST API 參考了解更多功能
設定 Webhook 接收郵件狀態通知
學習如何發送帶附件的郵件
了解定時發送和批次發送

遇到問題？查看我們的故障排查指南或聯絡支援團隊。

概述 REST API 參考