Sign inGet Started

Python

Wyślij pierwszy e-mail ze zwykłego skryptu Python, korzystając z synchronicznego klienta Bird Python SDK. Trzy kroki: zainstaluj, wyślij, uruchom.

1. Zainstaluj SDK

Przykład kodu
python -m pip install messagebird-sdk
Wymaga Pythona 3.10+. Pakiet do importu to bird.

2. Wyślij e-mail

Wyeksportuj klucz API. SDK odczytuje BIRD_API_KEY ze zmiennych środowiskowych i ustala region (us1 lub eu1) na podstawie prefiksu bk_us1_ / bk_eu1_, więc Bird() nie wymaga argumentów:
Przykład kodu
export BIRD_API_KEY="bk_us1_..."
Utwórz send.py:
Przykład kodu
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_ to pythonowy zapis pola from (from jest słowem zastrzeżonym). onboarding@messagebird.dev to wspólny nadawca onboardingowy Bird (nie wymaga weryfikacji domeny), a delivered@messagebird.dev to odbiorca sandbox, który zawsze doręcza wiadomość.
SDK automatycznie ponawia próby przy błędach przejściowych i przy każdej próbie używa tego samego klucza idempotentności wywołania. Dzięki temu ponowna próba nie wyśle wiadomości dwukrotnie.

3. Uruchom skrypt

Przykład kodu
python send.py
Skrypt wyświetla ID wiadomości i jej status:
Przykład kodu
em_01ky7ma8y2es1s2akzk53tmjn0 accepted
accepted to 202 API: Bird przyjął wiadomość i dostarczy ją asynchronicznie. Pobierz ją po em_ ID za pomocą client.email.get(message.id) i obserwuj, jak status zmienia się z accepted na delivered.

Następne kroki

Powiązane zasoby

Kontynuuj z dokumentacją, przewodnikami i przykładami dotyczącymi tego tematu. Zasoby są w języku angielskim.

Wypróbuj ćwiczenie i uzyskaj brief wdrożeniowy