Sign inGet Started

TypeScript · Astro

Astro API रूट से @messagebird/sdk के साथ ईमेल भेजें। आपको एक Bird API key चाहिए: Developers > API keys में जाकर एक बनाएँ (अपना पहला ईमेल भेजें में पूरी प्रक्रिया है), फिर इसे .env में BIRD_API_KEY के रूप में रखें।

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

कोड उदाहरण
npm create astro@latest my-app -- --template minimal --install --no-git --no-ai --yes
cd my-app
npm install @messagebird/sdk

2. भेजें

src/pages/api/send.ts बनाएँ। prerender = false इस रूट को सर्वर पर ऑन-डिमांड रेंडर कराता है; Astro .env वैल्यूज़ को import.meta.env पर उपलब्ध कराता है, और BIRD_API_KEY में PUBLIC_ प्रीफ़िक्स नहीं है, इसलिए यह केवल सर्वर-साइड रहता है:
कोड उदाहरण
import type { APIRoute } from "astro";
import { BirdClient } from "@messagebird/sdk";

export const prerender = false;

const bird = new BirdClient({ apiKey: import.meta.env.BIRD_API_KEY! });

export const POST: APIRoute = async () => {
  const msg = await bird.email.send({
    from: "onboarding@messagebird.dev",
    to: ["delivered@messagebird.dev"],
    subject: "Hello from Bird",
    html: "<p>My first Bird email.</p>",
  });

  console.log(msg.id, msg.status); // "em_…", "accepted"
  return Response.json({ id: msg.id, status: msg.status });
};
onboarding@messagebird.dev Bird का शेयर्ड ऑनबोर्डिंग सेंडर है और delivered@messagebird.dev एक सैंडबॉक्स प्राप्तकर्ता है जो हमेशा डिलीवर होता है: डोमेन सत्यापन की ज़रूरत नहीं। SDK आपकी key के bk_us1_ / bk_eu1_ प्रीफ़िक्स से रीजन का पता लगाता है (कोई बेस URL कॉन्फ़िगर नहीं करना) और हर कॉल पर एक Idempotency-Key ऑटो-जनरेट करता है, इसलिए फिर से भेजना सुरक्षित है।

3. आज़माएँ

डेव सर्वर चलाएँ और रूट पर POST करें:
कोड उदाहरण
npm run dev
curl -X POST http://localhost:4321/api/send
Bird ईमेल को 202 के साथ स्वीकार करता है और इसे एसिंक्रोनस रूप से डिलीवर करता है; आपका रूट em_ ID और स्टेटस लौटाता है:
कोड उदाहरण
{
  "id": "em_01ky7ma8y2es1s2akzk53tmjn0",
  "status": "accepted"
}
ऑन-डिमांड रूट्स को प्रोडक्शन में डिप्लॉय करने के लिए, @astrojs/node या @astrojs/vercel जैसा सर्वर अडैप्टर जोड़ें। स्टैटिक-ओनली बिल्ड इन्हें नहीं चला सकते।

अगले कदम

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

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

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