Python · Flask

使用 Bird Python SDK 的同步客户端，从 Flask 路由发送第一封邮件。三步完成：安装、发送、运行。

1. 安装 SDK

代码示例

python -m pip install messagebird-sdk flask

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

2. 发送邮件

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

代码示例

export BIRD_API_KEY="bk_us1_..."

创建 app.py。在模块加载时构造一个 Bird，并在各请求间复用：它会池化连接，且可安全地跨线程共享。

代码示例

from bird import Bird, APIError
from flask import Flask, jsonify

app = Flask(__name__)
client = Bird()


@app.post("/send")
def send():
    try:
        message = client.email.send(
            from_="onboarding@messagebird.dev",
            to=["delivered@messagebird.dev"],
            subject="Hello from Bird",
            html="<p>My first Bird email.</p>",
        )
    except APIError as err:
        return jsonify({"error": str(err)}), 502
    return jsonify({"id": message.id, "status": message.status}), 202

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

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

3. 试一试

代码示例

flask run
curl -X POST http://localhost:5000/send

Bird 以 202 接受消息并异步投递；你的路由返回 em_ ID 和状态：

代码示例

{
  "id": "em_01ky7ma8y2es1s2akzk53tmjn0",
  "status": "accepted"
}

使用 client.email.get(...) 通过 em_ ID 获取消息，观察状态从 accepted 变为 delivered。

后续步骤

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

Python · Flask

1. 安装 SDK

2. 发送邮件

3. 试一试

后续步骤

相关资源