快速开始

本指南将帮助您在几分钟内使用 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": "Hello from Zeabur Email!",
    "html": "<h1>Hello!</h1><p>This is my first email from Zeabur Email.</p>",
    "text": "Hello! This is my first email from 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: 'Hello from Zeabur Email!',
    html: '<h1>Hello!</h1><p>This is my first email from Zeabur Email.</p>',
    text: 'Hello! This is my first email from Zeabur Email.'
  })
});
 
const data = await response.json();
console.log('Email sent:', 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': 'Hello from Zeabur Email!',
        'html': '<h1>Hello!</h1><p>This is my first email from Zeabur Email.</p>',
        'text': 'Hello! This is my first email from Zeabur Email.'
    }
)
 
print('Email sent:', 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": "Hello from Zeabur Email!",
        "html":    "<h1>Hello!</h1><p>This is my first email from Zeabur Email.</p>",
        "text":    "Hello! This is my first email from 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("Email sent! Status:", resp.Status)
}

响应示例

成功发送后，您会收到如下响应：

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

下一步

现在您已经成功发送了第一封邮件！接下来可以：

查看 REST API 参考了解更多功能
配置 Webhook 接收邮件状态通知
学习如何发送带附件的邮件
了解定时发送和批量发送

遇到问题？查看我们的故障排查指南或联系支持团队。

概述 REST API 参考