Python · Flask

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

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

python -m pip install messagebird-sdk flask

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

2. ईमेल भेजें

अपनी API कुंजी एक्सपोर्ट करें। SDK एनवायरनमेंट से BIRD_API_KEY पढ़ता है और bk_us1_ / bk_eu1_ प्रीफ़िक्स से रीजन (us1 या eu1) तय करता है, इसलिए Bird() को किसी आर्ग्युमेंट की ज़रूरत नहीं होती:

export BIRD_API_KEY="bk_us1_..."

app.py बनाएँ। मॉड्यूल लोड होते समय एक Bird बनाएँ और उसे सभी अनुरोधों में दोबारा इस्तेमाल करें: यह कनेक्शन पूल करता है और इसे थ्रेड्स के बीच सुरक्षित रूप से साझा किया जा सकता है।

from bird import Bird, APIError
from flask import Flask, jsonify

app = Flask(__name__)
client = Bird()


@app.post("/send")
def send():
    try:
        message = client.email.send(
            from_="onboarding@messagebird.dev",
            to=["delivered@messagebird.dev"],
            subject="Hello from Bird",
            html="<p>My first Bird email.</p>",
        )
    except APIError as err:
        return jsonify({"error": str(err)}), 502
    return jsonify({"id": message.id, "status": message.status}), 202

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

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

3. इसे आज़माएँ

flask run
curl -X POST http://localhost:5000/send

Bird संदेश को 202 के साथ स्वीकार करता है और उसे एसिंक्रोनस रूप से डिलीवर करता है। आपका रूट em_ ID और स्टेटस लौटाता है:

{
  "id": "em_01ky7ma8y2es1s2akzk53tmjn0",
  "status": "accepted"
}

संदेश को उसकी em_ ID से client.email.get(...) के ज़रिए प्राप्त करें, और स्टेटस को accepted से delivered में बदलते हुए देखें।

अगले कदम

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