Sign inGet Started

Python · Flask

Bird Python SDK के sync क्लाइंट से Flask रूट के ज़रिए अपना पहला ईमेल भेजें। तीन चरण: इंस्टॉल करें, भेजें, चलाएँ।

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

कोड उदाहरण
python -m pip install messagebird-sdk flask
Python 3.10+ ज़रूरी है। इम्पोर्ट पैकेज bird है।

2. ईमेल भेजें

अपनी API key एक्सपोर्ट करें। 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 एक reserved word है)। onboarding@messagebird.dev Bird का शेयर्ड ऑनबोर्डिंग सेंडर है (डोमेन सत्यापन ज़रूरी नहीं) और delivered@messagebird.dev एक सैंडबॉक्स प्राप्तकर्ता है जो हमेशा डिलीवर होता है।
SDK अस्थायी विफलताओं पर अपने-आप फिर से प्रयास करता है और हर प्रयास में कॉल की idempotency key दोबारा इस्तेमाल करता है। इससे फिर से प्रयास करने पर मैसेज दो बार नहीं भेजा जाता।

3. आज़माएँ

कोड उदाहरण
flask run
curl -X POST http://localhost:5000/send
Bird मैसेज को 202 के साथ स्वीकार करता है और इसे असिंक्रोनस रूप से डिलीवर करता है; आपका रूट em_ ID और स्टेटस लौटाता है:
कोड उदाहरण
{
  "id": "em_01ky7ma8y2es1s2akzk53tmjn0",
  "status": "accepted"
}
client.email.get(...) से मैसेज को उसकी em_ ID से फ़ेच करें और स्टेटस को accepted से delivered में बदलते देखें।

अगले कदम

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

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

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