Sign inGet Started

Python

Bird Python SDK के sync client का उपयोग करके एक साधारण Python स्क्रिप्ट से अपना पहला ईमेल भेजें। तीन चरण: इंस्टॉल करें, भेजें, चलाएँ।

1. SDK इंस्टॉल करें

कोड उदाहरण
python -m pip install messagebird-sdk
Python 3.10+ आवश्यक है। import पैकेज bird है।

2. एक ईमेल भेजें

अपनी API key एक्सपोर्ट करें। SDK एनवायरनमेंट से BIRD_API_KEY पढ़ता है और bk_us1_ / bk_eu1_ प्रीफ़िक्स से रीजन (us1 या eu1) का अनुमान लगाता है, इसलिए Bird() को किसी आर्गुमेंट की ज़रूरत नहीं:
कोड उदाहरण
export BIRD_API_KEY="bk_us1_..."
send.py बनाएँ:
कोड उदाहरण
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_, from फ़ील्ड की Python स्पेलिंग है (from एक reserved word है)। onboarding@messagebird.dev, Bird का शेयर्ड ऑनबोर्डिंग सेंडर है (डोमेन सत्यापन की ज़रूरत नहीं) और delivered@messagebird.dev एक सैंडबॉक्स रिसीपिएंट है जो हमेशा डिलीवर होता है।
SDK अस्थायी विफलताओं पर अपने-आप फिर से प्रयास करता है और हर प्रयास पर कॉल की idempotency key दोबारा इस्तेमाल करता है। इससे फिर से प्रयास करने पर मैसेज दो बार नहीं भेजा जाता।

3. चलाएँ

कोड उदाहरण
python send.py
स्क्रिप्ट मैसेज ID और स्टेटस प्रिंट करती है:
कोड उदाहरण
em_01ky7ma8y2es1s2akzk53tmjn0 accepted
accepted API का 202 है: Bird के पास मैसेज है और वह इसे असिंक्रोनस रूप से डिलीवर करता है। इसे इसके em_ ID से client.email.get(message.id) के ज़रिए फ़ेच करें और स्टेटस को accepted से delivered में बदलते देखें।

अगले कदम

संबंधित संसाधन

इस विषय के लिए डॉक्यूमेंटेशन, गाइड और उदाहरणों के साथ आगे बढ़ें। संसाधन अंग्रेज़ी में हैं।

अभ्यास करें और इम्प्लीमेंटेशन ब्रीफ़ पाएँ