Python

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

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

python -m pip install messagebird-sdk

इसके लिए Python 3.10 या उससे नया संस्करण चाहिए। import पैकेज bird है।

2. ईमेल भेजें

अपनी API कुंजी export करें। 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)

Python में from फ़ील्ड को from_ लिखा जाता है, क्योंकि from एक आरक्षित शब्द है। onboarding@messagebird.dev, Bird का साझा ऑनबोर्डिंग प्रेषक है, जिसके लिए डोमेन सत्यापन की ज़रूरत नहीं होती। delivered@messagebird.dev एक सैंडबॉक्स प्राप्तकर्ता है, जिसे संदेश हमेशा डिलीवर होता है।

SDK अस्थायी विफलताओं के लिए अपने-आप फिर से प्रयास करता है और हर प्रयास में कॉल की idempotency कुंजी दोबारा इस्तेमाल करता है। इससे फिर से प्रयास के कारण संदेश दो बार नहीं भेजा जाता।

3. इसे चलाएँ

python send.py

स्क्रिप्ट मैसेज ID और स्थिति प्रिंट करती है:

em_01ky7ma8y2es1s2akzk53tmjn0 accepted

accepted, API का 202 है: Bird को मैसेज मिल गया है और वह उसे एसिंक्रोनस रूप से डिलीवर करता है। client.email.get(message.id) से उसकी em_ ID के ज़रिए उसे प्राप्त करें और स्थिति को accepted से delivered में बदलते हुए देखें।

अगले चरण

• Python SDK संदर्भ: हर मेथड और विकल्प।
• अपना पहला ईमेल भेजें: curl के साथ यही प्रक्रिया और सैंडबॉक्स पतों की पूरी सूची।
• भेजने वाले डोमेन: प्रोडक्शन में भेजने के लिए अपना डोमेन सत्यापित करें।
• Email API संदर्भ: पूरा अनुरोध और प्रतिक्रिया स्कीमा।