Python

使用 Bird Python SDK 的同步客户端，通过纯 Python 脚本发送你的第一封邮件。三个步骤：安装、发送、运行。

1. 安装 SDK

代码示例

python -m pip install messagebird-sdk

需要 Python 3.10+。导入包名为 bird。

2. 发送邮件

导出你的 API 密钥。SDK 从环境变量中读取 BIRD_API_KEY，并根据 bk_us1_ / bk_eu1_ 前缀推断区域（us1 或 eu1），因此 Bird() 无需传入参数：

代码示例

export BIRD_API_KEY="bk_us1_..."

创建 send.py：

代码示例

from bird import APIError, Bird

with Bird() as client:
    try:
        message = client.email.send(
            from_={"email": "onboarding@messagebird.dev", "name": "Bird"},
            to=["delivered@messagebird.dev"],
            subject="Hello from Bird",
            html="<p>My first Bird email.</p>",
        )
        print(message.id, message.status)
    except APIError as err:
        print("send failed:", err)

from_ 是 from 字段在 Python 中的写法（from 是保留字）。onboarding@messagebird.dev 是 Bird 的共享入门发件人（无需域名验证），delivered@messagebird.dev 是始终可送达的沙盒收件人。

SDK 会自动重试瞬时故障，并在每次尝试时复用该调用的幂等键。这可以防止重试导致消息被发送两次。

3. 运行

代码示例

python send.py

脚本会打印消息 ID 和状态：

代码示例

em_01ky7ma8y2es1s2akzk53tmjn0 accepted

accepted 是 API 的 202：Bird 已接收消息并会异步投递。通过 em_ ID 使用 client.email.get(message.id) 获取消息，可以观察状态从 accepted 变为 delivered。

后续步骤

Python SDK 参考文档：所有方法和选项。
发送你的第一封邮件：使用 curl 的相同流程及完整的沙盒地址列表。
发送域名：验证你自己的域名以用于生产环境发送。
Email API 参考文档：完整的请求和响应结构。

Python

1. 安装 SDK

2. 发送邮件

3. 运行

后续步骤

相关资源