नया गाइड: प्रतिष्ठा को नुकसान पहुँचाए बिना डेडिकेटेड IP को वार्म-अप कैसे करें। अभी पढ़ें →
MigoSMTP
ईमेल API

अपने कोड से ईमेल भेजें, ट्रैक करें और मैनेज करें

सेंडिंग, टेम्पलेट, इवेंट और रिपोर्टिंग के लिए REST API, स्कोप्ड की और साफ़ एरर के साथ।

एजेंट-रेडी: MCP सर्वर AI असिस्टेंट को सुरक्षित रूप से मेल भेजने और जाँचने देता है।

रिक्वेस्ट
POST /v1/send
{ "from": "hello@example.com",
"to": "you@example.com",
"subject": "Hello" }
रिस्पॉन्स
202 Accepted
{ "id": "msg_[id]" }
Idempotency-Key समर्थित
202 Accepted
JSON
Idempotent
एक JSON कॉल से भेजेंbearer की से प्रमाणित करें, छोटी JSON बॉडी पोस्ट करें और तुरंत मैसेज ID पाएँ।
क्विकस्टार्ट
cURL
Node
Python
PHP
Python
import migosmtp
c = migosmtp.Client("KEY")
c.send(to="you@example.com",
template="welcome")
Sent · 202
टाइप्ड SDK
ओपन सोर्स
आपके स्टैक के लिए आधिकारिक लाइब्रेरीNode, Python, PHP या Go चुनें। वही कुछ पंक्तियाँ संदेश भेजती हैं और हर जगह एरर एक ही तरह संभालती हैं।
API की स्कोप
ईमेल भेजेंअनुमत
इवेंट पढ़ेंअनुमत
डोमेन मैनेज करेंसिर्फ़ एडमिन
रेट लिमिट[n] req/s
न्यूनतम विशेषाधिकार
सुरक्षित रूप से रोटेट करें
ठीक उतनी एक्सेस वाली कीज़ जितनी ज़रूरी हैहर सर्विस के लिए एक की बनाएँ, हर एक की क्षमता सीमित करें, और बाकी को छुए बिना किसी एक को रिवोक करें।
रेट लिमिट
ट्रैफ़िक स्पाइक
क्यू स्पाइक को सँभाल लेती है
कुछ नहीं छूटता
बैकप्रेशर
डेटा लॉस नहीं
बर्स्ट को सहजता से सँभालेंजब ट्रैफ़िक आपकी रेट से ऊपर जाता है, तो रिक्वेस्ट फ़ेल होने के बजाय क्यू में लगती हैं और निकलती जाती हैं, इसलिए कुछ नहीं छूटता।
मैसेज इवेंट
हस्ताक्षरित इवेंट
/events
200 OK
डेटा वेयरहाउस
200 OK
अलर्ट
30s में रीट्राई
HMAC हस्ताक्षरित
At-least-once
इवेंट उसी तरह लौटते हैंवही API सतह डिलीवर, खोले, क्लिक किए और बाउंस हुए इवेंट आपके एंडपॉइंट पर, हस्ताक्षरित रूप में, वापस स्ट्रीम करती है।
प्रिया को इनवॉइस ईमेल करें और डिलीवरी की पुष्टि करें
AI एजेंट
MigoSMTP MCPस्कोप्ड की
send_emailसंदेश भेजें
get_eventsडिलीवरी नतीजे पढ़ें
check_domainDNS रिकॉर्ड सत्यापित करें
Sent · request id लॉग हुआ · डिलीवरी की पुष्टि
MCP तैयार
स्कोप्ड और लॉग किया हुआ
AI एजेंट को अपना API कॉल करने देंवही API MCP पर भी उपलब्ध है, ताकि एजेंट मेल भेज सके, इवेंट पढ़ सके और DNS सत्यापित कर सके। की स्कोप्ड होती हैं, कॉल लॉग होते हैं, और भेजने के लिए मंज़ूरी ज़रूरी की जा सकती है।
एक अनुरोध
SDK
स्कोप्ड की
रेट लिमिट
वेबहुक
एजेंट API
SMTP रिलेREST APIवेबहुकडेडिकेटेड IPDKIM साइनिंगइनबाउंड पार्सटेम्पलेटएनालिटिक्ससप्रेशन लिस्टप्रतिष्ठा मॉनिटरिंगईमेल वैलिडेशनटीम भूमिकाएँ और ऑडिट लॉगSMTP रिलेREST APIवेबहुकडेडिकेटेड IPDKIM साइनिंगइनबाउंड पार्सटेम्पलेटएनालिटिक्ससप्रेशन लिस्टप्रतिष्ठा मॉनिटरिंगईमेल वैलिडेशनटीम भूमिकाएँ और ऑडिट लॉग
क्षमताएँ

ऐसा API जो प्रोडक्शन में भरोसेमंद चले

REST एंडपॉइंट

संदेश, टेम्पलेट, डोमेन और इवेंट के लिए अनुमानित रिसोर्स।

टेम्पलेट और वेरिएबल

टेम्पलेट के नाम से भेजें और हर संदेश के लिए वेरिएबल दें।

इडेम्पोटेंसी की

डुप्लिकेट भेजे बिना सुरक्षित रूप से दोबारा कोशिश करें।

स्कोप्ड API की

हर सर्विस को सिर्फ़ उतनी अनुमतियाँ दें जितनी उसे चाहिए।

वेबहुक

हर डिलीवरी नतीजे के लिए हस्ताक्षरित इवेंट पाएँ।

साफ़ एरर और सीमाएँ

एक जैसे एरर कोड और रेट लिमिट हेडर।

यह कैसे काम करता है

आपकी सर्विसस्कोप्ड API की के साथ HTTPS पर सेंड एंडपॉइंट को कॉल करती है।
MigoSMTP ईमेल APIअनुरोध को वैलिडेट करता है, टेम्पलेट और सीमाएँ लागू करता है, संदेश को क्यू में डालता है और ID लौटाता है।
आप तक लौटते इवेंटहस्ताक्षरित webhook डिलीवरी, बाउंस और शिकायत के नतीजे आपके ऐप को बताते हैं।
चरण 1

API की बनाएँ

जो सर्विस इसे इस्तेमाल करेगी, उसके लिए स्कोप और IP allowlist चुनें।

चरण 2

अपना पहला संदेश भेजें

सत्यापित सेंडर और एक प्राप्तकर्ता के साथ सेंड एंडपॉइंट को कॉल करें।

चरण 3

इवेंट सुनें

डिलीवरी, बाउंस और एंगेजमेंट देखने के लिए webhook रजिस्टर करें।

इसे चलते देखें

पहले भेजने से इनबॉक्स तक, एक ही प्लेटफ़ॉर्म

चरणों के बीच स्विच करके देखें कि हर पड़ाव पर आपके हाथ में क्या है। यह सिर्फ़ उदाहरण इंटरफ़ेस है। दिखाए गए सभी आँकड़े और पते नमूना डेटा हैं।

app.migosmtp.com / sendनमूना डेटा
क्यू में
184,320
आज भेजे गए
6,418,905
रेट
412/s
स्वीकृतyou@example.com को संदेश
स्वीकृतteam@example.com को संदेश
क्यू में25,000 प्राप्तकर्ताओं का बैच
स्वीकृतops@example.com को संदेश
डेवलपर्स के लिए

वर्शन वाला, दस्तावेज़ीकृत और टेस्ट करने में आसान

डैशबोर्ड की हर चीज़ API से उपलब्ध है, और सैंपल आपकी इस्तेमाल की भाषाओं में हैं।

  • IP allowlist के साथ स्कोप्ड की
  • सुरक्षित रीट्राई के लिए इडेम्पोटेंट अनुरोध
  • एक जैसा एरर फ़ॉर्मैट
  • SDK और कॉपी-रेडी सैंपल
एक नज़र में
बेस URLapi.migosmtp.com/v1
प्रमाणीकरणBearer API की
फ़ॉर्मैटHTTPS पर JSON
इवेंटहस्ताक्षरित webhook
रेफ़रेंसपूरा API रेफ़रेंस और SDK सैंपल
ओवरव्यू

ईमेल API क्या है?

ईमेल API एक वेब इंटरफ़ेस है जिससे आपका कोड SMTP बोलने के बजाय HTTP एंडपॉइंट कॉल करके ईमेल भेजता और मैनेज करता है। MigoSMTP ईमेल API से आप सत्यापित सेंडर, प्राप्तकर्ता और कंटेंट या टेम्पलेट के नाम के साथ JSON अनुरोध POST करते हैं, और संदेश हमारे MigoMTA इन्फ्रास्ट्रक्चर से डिलीवरी के लिए क्यू में चला जाता है। जवाब में आपको उसे ट्रैक करने वाली ID मिलती है। आप सीधे HTTP से भी भेज सकते हैं।

यह API उन प्रोडक्ट टीमों के लिए है जिन्हें संदेश, टेम्पलेट, डोमेन और इवेंट के लिए अनुमानित रिसोर्स चाहिए। की स्कोप्ड होती हैं, इसलिए बिलिंग सर्विस रसीदें भेज सकती है पर डोमेन नहीं बदल सकती। इडेम्पोटेंसी की से रीट्राई सुरक्षित होते हैं, और एक जैसे एरर कोड व रेट लिमिट हेडर से क्लाइंट सलीके से रुक सकते हैं। डैशबोर्ड की हर चीज़ API से भी उपलब्ध है। अलग वर्कस्पेस और की से सैंडबॉक्स और प्रोडक्शन ट्रैफ़िक अलग रखा जा सकता है, जिससे टेस्ट सेंड आपकी लाइव रिपोर्टिंग और प्रतिष्ठा से बाहर रहते हैं।

डिलीवरेबिलिटी के लिए API वह नियंत्रण देता है जो SMTP नहीं दे सकता: स्ट्रक्चर्ड एरर, प्रति-संदेश मेटाडेटा और इवेंट webhook जिन्हें आप अपने एप्लिकेशन में वापस जोड़ सकते हैं। इसे सप्रेशन हैंडलिंग के साथ जोड़ें तो खराब पतों पर मेल भेजना अपने आप बंद हो जाता है। हमारा MCP सर्वर AI एजेंट को स्कोप्ड, रद्द की जा सकने वाली की के तहत वही API कॉल करने देता है, ताकि ऑटोमेशन आपकी तय सीमाओं में रहे। हर की स्कोप्ड और लॉग होती है, इसलिए आप ठीक-ठीक देख सकते हैं कि किस सर्विस या एजेंट ने कौन-सा संदेश भेजा, और ज़रूरत पड़ने पर तुरंत एक्सेस रद्द कर सकते हैं।

उपयोग के मामले

ईमेल API के आम इस्तेमाल

आपके ऐप से ट्रांज़ैक्शनल ईमेल

एक API कॉल से रसीदें, पासवर्ड रीसेट और अलर्ट भेजें। टेम्पलेट के नाम से भेजें और वेरिएबल दें, ताकि प्रोडक्ट कोड HTML से मुक्त रहे और कॉपी बदलना आसान हो।

जॉब क्यू में सुरक्षित रीट्राई

हर सेंड के साथ इडेम्पोटेंसी की लगाएँ। अगर कोई वर्कर क्रैश होकर दोबारा कोशिश करे, तो ईमेल API डुप्लिकेट पहचान लेता है और वही संदेश दो बार नहीं भेजता।

माइक्रोसर्विस में प्रति-सर्विस की

IP allowlist के साथ हर सर्विस के लिए एक स्कोप्ड की जारी करें। कोई सर्विस compromise हो जाए तो आप सिर्फ़ एक की रद्द करते हैं और बाकी ईमेल पाइपलाइन चलती रहती है।

इवेंट से लूप पूरा करना

सेंड एंडपॉइंट को webhook के साथ जोड़ें ताकि आपके डेटाबेस में डिलीवर, बाउंस और शिकायत की स्थिति दिखे। तब सपोर्ट टीम लॉग खोले बिना बता सकती है कि ईमेल कहाँ गया।

SaaS प्रोडक्ट से नोटिफ़िकेशन

इन्विटेशन, उपयोग अलर्ट और बिलिंग सूचनाओं जैसे इन-ऐप इवेंट एक ही API से भेजें, हर सर्विस के लिए एक की और प्रोडक्ट टीम के अधीन टेम्पलेट के साथ।

एजेंट और ऑटोमेशन

किसी AI एजेंट या इंटरनल टूल को ऐसी स्कोप्ड की दें जो सिर्फ़ भेज सके या सिर्फ़ स्थिति पढ़ सके। हर कॉल उसी की के नाम से लॉग होती है, इसलिए आप देख सकते हैं कि उसने क्या किया और कभी भी उसे रद्द कर सकते हैं।

तरीका चुनना

ईमेल API या SMTP रिले?

दोनों एक ही इन्फ्रास्ट्रक्चर से डिलीवर करते हैं। चुनाव इस पर निर्भर है कि आपका सॉफ़्टवेयर कैसे बना है।

ईमेल APISMTP रिले
इनके लिए सबसे अच्छानया कोड जिसे टेम्पलेट, इडेम्पोटेंसी और स्ट्रक्चर्ड जवाब चाहिएमौजूदा ऐप, CMS प्लगइन और डिवाइस जो पहले से SMTP बोलते हैं
इंटीग्रेशनकिसी भी भाषा से HTTPS और JSONआपकी मेल सेटिंग में होस्ट और क्रेडेंशियल
एररस्ट्रक्चर्ड एरर कोड और रेट लिमिट हेडरSMTP रिस्पॉन्स कोड
एक्सेस कंट्रोलस्कोप्ड API की, वैकल्पिक IP allowlistप्रति-अकाउंट क्रेडेंशियल और IP allowlist

आप दोनों एक ही वर्कस्पेस में इस्तेमाल कर सकते हैं: जिन टूल को बदला नहीं जा सकता उनके लिए SMTP, और नई सर्विस के लिए API।

AI फ़ीचर

AI-सहायता वाला ईमेल API

एजेंट-रेडी

AI एजेंट के लिए MCP सर्वर

AI असिस्टेंट को MCP सर्वर के ज़रिए MigoSMTP से जोड़ें ताकि वह संदेश की स्थिति देख सके या भेजने का ड्राफ़्ट बना सके। की में वही स्कोप रहते हैं जो आप देते हैं, और भेजने के लिए इंसान की मंज़ूरी ज़रूरी की जा सकती है।

कोपायलट

एरर ट्राइएज कोपायलट

कोई API एरर या फ़ेल अनुरोध पेस्ट करें, तो कोपायलट कारण बताता है, जैसे असत्यापित सेंडर या गलत फ़ील्ड, और सुधरी हुई कॉल दिखाता है। सुधार आप खुद लागू करते हैं।

असिस्ट

AI से ड्राफ़्ट किया इंटीग्रेशन कोड

बताएँ कि आप क्या भेजना चाहते हैं, तो असिस्टेंट हमारे SDK के तौर-तरीकों के अनुसार आपकी भाषा में सैंपल अनुरोध बनाता है। प्रोडक्शन में जाने से पहले उसे जाँचें और टेस्ट करें।

पूर्वानुमानित

स्पाइक और दुरुपयोग की पहचान

एनोमली डिटेक्शन हर की की भेजने की दर पर नज़र रखता है और असामान्य उछाल को चिह्नित करता है। यह आपकी टीम को सूचित कर सकता है या की रोकने का सुझाव दे सकता है, और कोई भी स्वचालित कार्रवाई तभी होती है जब आप उसे चुनें।

AI सुविधाएँ सहायक और वैकल्पिक हैं: एजेंट सिर्फ़ आपके दिए स्कोप में काम करते हैं, और की व सेंड पर नियंत्रण आपकी टीम का रहता है।

बेस्ट प्रैक्टिस

ईमेल API के बेस्ट प्रैक्टिस

हर सेंड पर इडेम्पोटेंसी की इस्तेमाल करें

हर तार्किक ईमेल के लिए एक स्थिर की बनाएँ, जैसे ऑर्डर ID और इवेंट। इससे टाइमआउट के बाद रीट्राई पर डुप्लिकेट संदेश नहीं बनते।

की को न्यूनतम स्कोप दें

हर सर्विस को सिर्फ़ ज़रूरी अनुमतियाँ दें, और जहाँ पते तय हों वहाँ IP allowlist जोड़ें। छोटा ब्लास्ट रेडियस यानी आसान इंसिडेंट रिस्पॉन्स।

रेट लिमिट हेडर का सम्मान करें

हर रिस्पॉन्स में लिमिट हेडर पढ़ें और थ्रॉटल होने से पहले रुकें। जिटर के साथ एक्सपोनेंशियल बैकऑफ़ API पर बोझ डाले बिना बर्स्ट संभाल लेता है।

webhook सिग्नेचर सत्यापित करें

हर इवेंट पर भरोसा करने से पहले उसका सिग्नेचर जाँचें। सीक्रेट को तय समय पर रोटेट करें, और लीक होने की आशंका हो तो तुरंत।

मैसेज ID सहेजें

सेंड कॉल से लौटी ID को अपने रिकॉर्ड के साथ सहेजें। इससे बाद में सपोर्ट लुकअप और इवेंट रीकंसिलिएशन आसान हो जाता है।

टेस्ट और लाइव अलग रखें

स्टेजिंग और प्रोडक्शन के लिए अलग वर्कस्पेस और की इस्तेमाल करें। तब टेस्ट की गलतियाँ असली प्राप्तकर्ताओं तक नहीं पहुँचतीं और आपकी प्रतिष्ठा पर असर नहीं डालतीं।

FAQ

ईमेल API: अक्सर पूछे जाने वाले प्रश्न

इंटीग्रेशन में मदद चाहिए? लाइव होने से पहले हमारी टीम आपके साथ उसकी समीक्षा कर सकती है।

ईमेल API क्या होता है?

ईमेल API HTTP एंडपॉइंट का एक सेट है जिससे आपका सॉफ़्टवेयर मेल सर्वर चलाए बिना ईमेल भेज और मैनेज कर सकता है। आप JSON अनुरोध भेजते हैं, प्रोवाइडर संदेश को क्यू करके डिलीवर करता है, और स्थिति के अपडेट आपको रिस्पॉन्स और webhook से मिलते हैं।

MigoSMTP API से ईमेल कैसे भेजूँ?

API की बनाएँ, सेंडर डोमेन सत्यापित करें, फिर सेंड एंडपॉइंट पर from पता, प्राप्तकर्ता और कंटेंट या वेरिएबल वाले टेम्पलेट के साथ JSON POST करें। रिस्पॉन्स में मैसेज ID मिलती है जिसे आप ट्रैक कर सकते हैं। फ़ील्ड के लिए API रेफ़रेंस देखें।

ईमेल API और SMTP में क्या अंतर है?

SMTP एक प्रोटोकॉल है जिसे मौजूदा सॉफ़्टवेयर पहले से बोलता है, इसलिए कोड बदलने की ज़रूरत नहीं। API HTTPS और JSON इस्तेमाल करता है, जिससे स्ट्रक्चर्ड एरर, टेम्पलेट, इडेम्पोटेंसी और मेटाडेटा मिलते हैं। दोनों एक ही डिलीवरी इन्फ्रास्ट्रक्चर इस्तेमाल करते हैं, इसलिए अपने एप्लिकेशन की बनावट के अनुसार चुनें।

क्या ईमेल API को टेस्ट करने के लिए सैंडबॉक्स है?

टेस्टिंग के लिए अलग वर्कस्पेस और API की इस्तेमाल करें, ताकि टेस्ट सेंड आपकी लाइव रिपोर्टिंग और सेंडर प्रतिष्ठा से बाहर रहें। टेस्ट और लाइव सेंडिंग के बीच कभी की साझा न करें। आपके अकाउंट के लिए टेस्ट मोड चाहिए तो हमसे पूछें।

API रेट लिमिट कैसे लागू होती हैं?

लिमिट रिस्पॉन्स हेडर में लौटाई जाती हैं, ताकि आपका क्लाइंट बची हुई क्षमता देख सके और थ्रॉटल होने से पहले रुक सके। आप पर लागू मान आपके प्लान पर निर्भर करते हैं। ऐसे क्लाइंट बनाएँ जो हेडर पढ़ें और सहजता से धीमे हों।

क्या मैं बैच में ईमेल भेज सकता हूँ?

आपके प्लान पर लागू बैच विकल्पों और प्राप्तकर्ता सीमाओं के लिए API रेफ़रेंस देखें। बैच कितना भी बड़ा हो, हर अनुरोध के साथ इडेम्पोटेंसी की भेजें और रेट लिमिट हेडर का सम्मान करें, ताकि आंशिक विफलता पर बिना डुप्लिकेट के दोबारा कोशिश हो सके।

MigoSMTP MCP सर्वर क्या है?

MCP सर्वर AI असिस्टेंट के लिए टूल कॉल करने का एक मानक तरीका है। हमारा सर्वर संगत एजेंट को ईमेल API के साथ काम करने देता है, जैसे संदेश की स्थिति जाँचना, आपके नियंत्रण वाली स्कोप्ड की से। भेजने के लिए किसी व्यक्ति की मंज़ूरी ज़रूरी की जा सकती है।

कौन-सी भाषाएँ और SDK समर्थित हैं?

यह HTTPS पर REST API है, इसलिए HTTP अनुरोध कर सकने वाली कोई भी भाषा चलती है। कॉपी-रेडी सैंपल और SDK दस्तावेज़ में सूचीबद्ध हैं। API की को एनवायरनमेंट वेरिएबल या सीक्रेट मैनेजर में रखें, सोर्स कोड में कभी नहीं।

मिनटों में भेजना शुरू करें।

खाता बनाएँ, अपना डोमेन जोड़ें और पहला ईमेल भेजें।