कोड उदाहरण

कोई भी HTTP क्लाइंट या SMTP लाइब्रेरी इस्तेमाल करें। ये उदाहरण सीधे REST API को कॉल करते हैं, और आप अपनी पसंदीदा लाइब्रेरी लगा सकते हैं।

इंटीग्रेट कैसे करें

भेजने के दो तरीके हैं: HTTPS पर REST API, या मानक SMTP। API नए कोड के लिए उपयुक्त है और संरचित नतीजे देता है। SMTP मौजूदा एप्लिकेशन और टूल्स के लिए उपयुक्त है। दोनों API की से प्रमाणित होते हैं।

Node.js

Node के मौजूदा वर्शन के बिल्ट-इन fetch का उपयोग करता है।

const res = await fetch("https://api.migosmtp.com/v1/send", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.MIGOSMTP_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ from, to, subject, text }),
});
if (!res.ok) throw new Error(`send failed: ${res.status}`);
const { id } = await res.json();

Python

requests लाइब्रेरी का उपयोग करता है।

import os, requests

r = requests.post(
    "https://api.migosmtp.com/v1/send",
    headers={"Authorization": f"Bearer {os.environ['MIGOSMTP_KEY']}"},
    json={"from": sender, "to": to, "subject": subject, "text": text},
    timeout=10,
)
r.raise_for_status()

PHP

cURL का उपयोग करता है, जो ज़्यादातर PHP इंस्टॉल के साथ आता है।

$ch = curl_init("https://api.migosmtp.com/v1/send");
curl_setopt_array($ch, [
  CURLOPT_POST => true,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ["Authorization: Bearer " . getenv("MIGOSMTP_KEY"), "Content-Type: application/json"],
  CURLOPT_POSTFIELDS => json_encode(["from" => $from, "to" => $to, "subject" => $subject, "text" => $text]),
]);
$body = curl_exec($ch);

किसी भी भाषा के लिए अच्छी आदतें

हर अनुरोध पर टाइमआउट सेट करें। रिट्राई सिर्फ़ 429 और 5xx रिस्पॉन्स पर करें, एक्सपोनेंशियल बैकऑफ़ और जिटर के साथ। 429 के अलावा किसी 4xx को कभी रिट्राई न करें, क्योंकि अनुरोध उसी तरह विफल होगा। हर सेंड से लौटा मैसेज id लॉग करें ताकि बाद में उसे ट्रेस कर सकें।

SMTP लाइब्रेरी

कोई भी SMTP लाइब्रेरी चलती है: Nodemailer, PHPMailer, Python smtplib, Java Mail और ज़्यादातर फ़्रेमवर्क में बना SMTP सपोर्ट। कनेक्शन सेटिंग के लिए SMTP इंटीग्रेशन गाइड देखें।