Zeabur Emailクイックスタート

クイックスタート

このガイドでは、Zeabur Emailを使用して数分で最初のメールを送信する方法を説明します。

前提条件

開始する前に、以下が必要です：

  1. Zeaburアカウント
  2. Zeaburコンソールで有効化されたZeabur Emailサービス
  3. 少なくとも1つの検証済み送信者ドメイン
  4. APIキー

ステップ1：APIキーを作成

Zeaburコンソールにログイン

Zeabur Dashboardにアクセスし、アカウントにログインします。

Zeabur Email管理に移動

コンソールでZeabur Emailサービスを見つけ、管理ページに入ります。

新しいAPIキーを作成

  1. 「APIキーを作成」ボタンをクリック
  2. 権限タイプを選択：
    • 読み取り専用：メールステータスのクエリのみ可能
    • 送信専用：メールの送信とステータスのクエリが可能（本番環境推奨）
    • フルアクセス：すべての操作権限を含む
  3. オプション：ドメイン権限の制限（特定のドメインからのみ送信可能）
  4. 「作成」をクリック
⚠️

作成後すぐに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 リファレンス