Python
Senden Sie Ihre erste E-Mail aus einem einfachen Python-Skript mit dem synchronen Client des Bird Python SDK. Drei Schritte: installieren, senden, ausführen.
1. SDK installieren
Codebeispiel
python -m pip install messagebird-sdkErfordert Python 3.10+. Das Import-Paket ist bird.
2. Eine E-Mail senden
Exportieren Sie Ihren API-Schlüssel. Der SDK liest BIRD_API_KEY aus der Umgebung und leitet die Region (us1 oder eu1) aus dem Präfix bk_us1_ / bk_eu1_ ab, sodass Bird() keine Argumente benötigt:
Codebeispiel
export BIRD_API_KEY="bk_us1_..."Erstellen Sie send.py:
Codebeispiel
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_ ist die Python-Schreibweise des Feldes from (from ist ein reserviertes Wort). onboarding@messagebird.dev ist der gemeinsame Onboarding-Absender von Bird (keine Domain-Verifizierung nötig) und delivered@messagebird.dev ist ein Sandbox-Empfänger, der immer zugestellt wird.
Der SDK wiederholt fehlgeschlagene Anfragen bei vorübergehenden Fehlern automatisch und verwendet bei jedem Versuch den Idempotenzschlüssel des Aufrufs erneut. Das verhindert, dass ein erneuter Versuch die Nachricht doppelt sendet.
3. Ausführen
Codebeispiel
python send.pyDas Skript gibt die Nachrichten-ID und den Status aus:
Codebeispiel
em_01ky7ma8y2es1s2akzk53tmjn0 acceptedaccepted ist der 202 des API: Bird hat die Nachricht und stellt sie asynchron zu. Rufen Sie sie über ihre em_-ID mit client.email.get(message.id) ab und beobachten Sie, wie der Status von accepted zu delivered wechselt.
Nächste Schritte
- Python-SDK-Referenz: alle Methoden und Optionen.
- Erste E-Mail senden: derselbe Ablauf mit curl und die vollständige Sandbox-Adressliste.
- Sende-Domains: eigene Domain für den Produktionsversand verifizieren.
- E-Mail-API-Referenz: das vollständige Request- und Response-Schema.
Verwandte Ressourcen
Weiter mit der Dokumentation, Anleitungen und Beispielen zu diesem Thema. Die Ressourcen sind auf Englisch.
Anleitung ansehenTesting email without spamming anyoneDie Funktion erkundenTest email deliveryDem Lernpfad folgenOperate messaging reliably
Übung ausprobieren und ein Implementierungs-Briefing erhalten