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-sdkWymaga 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.pySkrypt wyświetla ID wiadomości i jej status:
Przykład kodu
em_01ky7ma8y2es1s2akzk53tmjn0 acceptedaccepted 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
- Dokumentacja Python SDK: wszystkie metody i opcje.
- Wyślij swój pierwszy e-mail: ten sam przepływ z curl i pełna lista adresów sandbox.
- Domeny wysyłkowe: zweryfikuj własną domenę do wysyłki produkcyjnej.
- Dokumentacja Email API: pełny schemat żądania i odpowiedzi.
Powiązane zasoby
Kontynuuj z dokumentacją, przewodnikami i przykładami dotyczącymi tego tematu. Zasoby są w języku angielskim.
Obejrzyj przewodnikTesting email without spamming anyonePoznaj możliwościTest email deliveryPodążaj ścieżką naukiOperate messaging reliably
Wypróbuj ćwiczenie i uzyskaj brief wdrożeniowy