Python

Verstuur je eerste e-mail vanuit een eenvoudig Python-script met de sync-client van de Bird Python SDK. Drie stappen: installeren, versturen, uitvoeren.

1. Installeer de SDK

Codevoorbeeld

python -m pip install messagebird-sdk

Vereist Python 3.10+. Het importpakket is bird.

2. Verstuur een e-mail

Exporteer je API-sleutel. De SDK leest BIRD_API_KEY uit de omgeving en leidt de regio (us1 of eu1) af uit het bk_us1_ / bk_eu1_-voorvoegsel, dus Bird() heeft geen argumenten nodig:

Codevoorbeeld

export BIRD_API_KEY="bk_us1_..."

Maak send.py aan:

Codevoorbeeld

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_ is de Python-schrijfwijze van het from-veld (from is een gereserveerd woord). onboarding@messagebird.dev is de gedeelde onboarding-afzender van Bird (geen domeinverificatie nodig) en delivered@messagebird.dev is een sandbox-ontvanger die altijd aflevert.

De SDK probeert tijdelijke fouten automatisch opnieuw en hergebruikt de idempotentiesleutel van de aanroep bij elke poging. Dit voorkomt dat een nieuwe poging het bericht dubbel verstuurt.

3. Voer het uit

Codevoorbeeld

python send.py

Het script toont het bericht-ID en de status:

Codevoorbeeld

em_01ky7ma8y2es1s2akzk53tmjn0 accepted

accepted is de 202 van de API: Bird heeft het bericht en bezorgt het asynchroon. Haal het op via zijn em_-ID met client.email.get(message.id) en volg hoe de status verandert van accepted naar delivered.

Volgende stappen

Python SDK-referentie: elke methode en optie.
Verstuur je eerste e-mail: dezelfde flow met curl en de volledige sandbox-adreslijst.
Verzenddomeinen: verifieer je eigen domein voor productieverzending.
E-mail API-referentie: het volledige request- en responseschema.

Gerelateerde bronnen

Ga verder met de documentatie, gidsen en voorbeelden voor dit onderwerp. De bronnen zijn in het Engels.

Bekijk de gidsTesting email without spamming anyone Ontdek de mogelijkheidTest email delivery Volg het leerpadOperate messaging reliably

Probeer de oefening en ontvang een implementatieoverzicht