OTP बनाना, पढ़ना और सत्यापित करना कैसे अलग हैं?

आपको अपने ऐप का ईमेल सत्यापन जाँचना है, इसलिए केवल कोई नया कोड मिल जाना पर्याप्त नहीं है। कोड उसी परीक्षण का होना चाहिए जिसे आपने अभी शुरू किया है। यह प्रक्रिया आपके अपने परीक्षण मेलबॉक्स और अधिकृत कार्यप्रवाह के लिए है।

OTP एक बार इस्तेमाल होने वाला कोड है। ईमेल से जुड़े परीक्षण में इसे बनाने, पढ़ने और सत्यापित करने की जिम्मेदारियाँ अलग रखें:

कामजिम्मेदारी
कोड बनाना और भेजनाआपका ऐप या पहचान सेवा
प्राप्त ईमेल से कोड पढ़नाMailera का OTP अनुरोध
कोड स्वीकार या अस्वीकार करनासंबंधित ऐप की सत्यापन प्रक्रिया

Mailera मौजूदा मेलबॉक्स को ऐप से जोड़ता है। दूसरे मेलबॉक्स पर भी यही प्रक्रिया लागू करनी हो तो अपने इनबॉक्स से OTP पढ़ने की सामान्य मार्गदर्शिका देखें।

परीक्षण ऐप से Hotmail पर ईमेल, Mailera से कोड पढ़ना और ऐप में सत्यापन करने का प्रवाह
कोड पढ़ने और उसे स्वीकार करने की जिम्मेदारी अलग है।

Hotmail मेलबॉक्स और API कुंजी कैसे तैयार करें?

1. Microsoft OAuth से मेलबॉक्स जोड़ें

Admin या Leader भूमिका से मेलबॉक्स → मेलबॉक्स जोड़ें → Microsoft से साइन इन करें खोलें। अपने Hotmail परीक्षण खाते से साइन इन करें और Microsoft पर OAuth सहमति दें। कनेक्शन का विवरण Mailera के Microsoft प्रदाता पृष्ठ पर है।

Microsoft की उपयोगकर्ता की ओर से पहुँच लेने की प्रक्रिया में उपयोगकर्ता अपने ऐप को अपनी ओर से काम करने की अनुमति देता है। यह संदर्भ 25 अक्टूबर 2026 को पढ़ा गया था।

इस कनेक्शन में ऐप पासवर्ड (app password) का इस्तेमाल नहीं होता। पुराने सेटअप में यही अड़चन हो तो Outlook में app password की जगह OAuth अपनाने का तरीका देखें।

2. मेलबॉक्स सूची में सही खाता पहचानें

मेलबॉक्स पृष्ठ पर जुड़े खाते को देखें। केवल प्रदर्शित नाम के आधार पर चुनाव न करें; परीक्षण का पता भी मिलाएँ। अगले API अनुरोध के लिए इसी खाते का id चाहिए।

3. केवल परीक्षण समूह की read कुंजी बनाएँ

सेटिंग्स में API key टैब खोलें और API key बनाएँ चुनें। पहचानने योग्य नाम में परीक्षण का उद्देश्य लिखें। मेलबॉक्स का दायरा में वह समूह चुनें जिसमें आपके परीक्षण मेलबॉक्स हैं, और केवल read अनुमति रखें।

कुंजी की पहुँच पूरे समूह तक होती है, किसी एक मेलबॉक्स तक सीमित नहीं की जा सकती। इसलिए परीक्षण समूह में निजी या उत्पादन वाले मेलबॉक्स न रखें। Admin सभी समूह भी चुन सकते हैं, लेकिन इस परीक्षण कुंजी को इतनी व्यापक पहुँच न दें।

Microsoft OAuth की अनुमतियाँ तय करती हैं कि ऐप Microsoft से क्या पढ़ सके। Mailera कुंजी का read scope तय करता है कि आपका सर्वर Mailera से क्या पढ़ सके। ये दोनों अलग परतें हैं। Microsoft की Graph अनुमतियों की सूची भी केवल आवश्यक न्यूनतम अनुमति माँगने की सलाह देती है; संदर्भ 25 अक्टूबर 2026 को पढ़ा गया था।

Mailera में परीक्षण मेलबॉक्स समूह तक सीमित read अनुमति वाली API कुंजी का विन्यास
कुंजी का दायरा समूह तक सीमित करें; समूह की सीमा किसी एक मेलबॉक्स की अलग अनुमति नहीं है।

नई कुंजी केवल एक बार दिखाई जाती है। उसे सर्वर के गुप्त मानों में सहेजें और $MAILERA_API_KEY पर्यावरण चर से उपलब्ध कराएँ। ब्राउज़र के कोड या रिपॉज़िटरी में न रखें।

अब मेलबॉक्स की सूची लें:

curl --silent --show-error \
  'https://mailera.app/api/public/v1/mailboxes' \
  -H "Authorization: Bearer $MAILERA_API_KEY"

प्रतिक्रिया के data में परीक्षण खाते का email पहचानें और उसी प्रविष्टि का id, $MAILBOX_ID में रखें। सूची की पहली प्रविष्टि को अपने आप चुनने से बचें। REST एकीकरण का परिचय Mailera के डेवलपर पृष्ठ पर है।

API से सही और नया OTP कैसे लें?

4. परीक्षण शुरू करें और उसका समय दर्ज करें

अपने ऐप में उसी Hotmail पते के लिए सत्यापन ईमेल भेजने की प्रक्रिया शुरू करें। परीक्षण शुरू होने का समय और उस परीक्षण की पहचान अपने परीक्षण रनर में रखें। यदि आप ईमेल का विषय तय कर सकते हैं, तो उसमें परीक्षण की अलग पहचान देने से मिलान करना आसान होता है।

एक ही मेलबॉक्स और एक जैसे विषय पर कई परीक्षण साथ चलाने के बजाय उन्हें अलग रखें।

5. फ़िल्टर के साथ OTP अनुरोध भेजें

GET /mailboxes/{id}/otp का getOtp ऑपरेशन नवीनतम OTP पढ़ता है और उसे read अनुमति चाहिए। अनुरोध में मेलबॉक्स के साथ फ़िल्टर दें:

पैरामीटरउद्देश्य
idअपने परीक्षण मेलबॉक्स की पहचान; URL के पथ में जाता है
fromअपेक्षित भेजने वाले से संबंधित फ़िल्टर
subjectअपेक्षित विषय से संबंधित फ़िल्टर
since_minutesgetOtp में उपलब्ध पैरामीटर

यहाँ qa-sender@example.com और Verification test-run-A उदाहरण हैं। इन्हें अपने ऐप के भेजने वाले और विषय से बदलें।

curl --silent --show-error --get \
  "https://mailera.app/api/public/v1/mailboxes/$MAILBOX_ID/otp" \
  -H "Authorization: Bearer $MAILERA_API_KEY" \
  --data-urlencode 'from=qa-sender@example.com' \
  --data-urlencode 'subject=Verification test-run-A' \
  --data-urlencode 'since_minutes=5'

आधार URL https://mailera.app/api/public/v1 है। कुंजी Authorization: Bearer शीर्षलेख में जाती है। उपलब्ध ऑपरेशन और पैरामीटर Mailera के API दस्तावेज़ों में दिए हैं।

6. कोड इस्तेमाल करने से पहले संदेश मिलाएँ

कोड सबसे नया है, इससे यह तय नहीं होता कि वह सही परीक्षण का है। पहले मेलबॉक्स, भेजने वाला, विषय और संदेश मिलने का समय देखें। संदर्भ के लिए GET /mailboxes/{id}/messages से संदेशों की सूची लें:

curl --silent --show-error --get \
  "https://mailera.app/api/public/v1/mailboxes/$MAILBOX_ID/messages" \
  -H "Authorization: Bearer $MAILERA_API_KEY" \
  --data-urlencode 'folder=inbox' \
  --data-urlencode 'from=qa-sender@example.com'

सूची की data प्रविष्टियों में mailbox_id, from.address, subject और received_at देखें। संबंधित संदेश का id, $MESSAGE_ID में रखें। पूरा संदेश पढ़ने का अनुरोध यह है:

curl --silent --show-error \
  "https://mailera.app/api/public/v1/mailboxes/$MAILBOX_ID/messages/$MESSAGE_ID" \
  -H "Authorization: Bearer $MAILERA_API_KEY"

इस प्रतिक्रिया में संदेश की सामग्री data.body.text और data.body.html में मिलती है। परीक्षण से संबंध जाँचने के लिए सामग्री पढ़ें, लेकिन उसे सामान्य लॉग में न लिखें।

received_at को परीक्षण शुरू होने के समय से मिलाएँ, पर केवल समय के आधार पर फैसला न करें। देर से आया पुराना ईमेल भी जाँच के समय हाल का दिख सकता है। विषय में परीक्षण की पहचान या ऐप का अन्य संदर्भ न मिले और कई संदेश संभव लगें, तो कोड चुनने के बजाय परीक्षण रोकें।

अपने रनर में पुनःप्रयासों की अधिकतम संख्या और कुल प्रतीक्षा समय तय करें। हर बार नया OTP माँगने के बजाय पहले यह जाँचें कि अपेक्षित संदेश पहले ही आ चुका है या नहीं। Mailera की API सीमा प्रति कुंजी प्रति मिनट 300 अनुरोध है; इसे लगातार अनुरोध भेजने का लक्ष्य न बनाएँ।

Hotmail OTP नहीं आ रहा तो कौन-सी आम गलतियाँ जाँचें?

पहले जाँचें कि संदेश आया ही नहीं है, दूसरे फ़ोल्डर में है, या आपके फ़िल्टर से बाहर है।

लक्षणजाँचअगला कदम
दूसरे परीक्षण का कोड दिखता हैचुने हुए id का email और संदेश का विषयसही मेलबॉक्स चुनें; समानांतर परीक्षण अलग करें
संदेश दिखता है, OTP नहीं मिलताभेजने वाले और विषय के फ़िल्टरवास्तविक संदेश से फ़िल्टर मिलाएँ
पुराने प्रयास का संदेश मिलता हैपरीक्षण शुरू होने का समय और received_atपुराने संदेश को इस्तेमाल न करें
नया मेल नहीं दिखताGET /mailboxes/{id}/statusMicrosoft साइन-इन की स्थिति देखें; जरूरत पर फिर कनेक्ट करें
Inbox में संदेश नहीं हैGET /mailboxes/{id}/placement और Junk फ़ोल्डरसंदेश का स्थान पहचानें

placement ऑपरेशन के लिए read पर्याप्त है। इसमें भी from, subject और since_minutes पैरामीटर उपलब्ध हैं। Junk को अलग से देखें; Inbox की सूची में संदेश न दिखने पर उसे अनुपस्थित न मानें।

अगर मैन्युअल सिंक चाहिए, तो POST /mailboxes/{id}/sync के लिए अलग sync अनुमति चाहिए। OTP पढ़ने वाली read कुंजी को पर्याप्त न समझें।

Junk से संदेश हटाने की स्पैम नहीं है कार्रवाई के लिए API कुंजी में "Move messages" अनुमति चाहिए। नियमित OTP परीक्षण की कुंजी में यह अनुमति जोड़ने के बजाय अलग अधिकृत कार्रवाई रखें।

OTP और मेलबॉक्स की सुरक्षा कैसे रखें?

OTP को केवल उस परीक्षण में दें जिसके लिए वह आया है। स्क्रीनशॉट, साझा रिपोर्ट और लॉग में कोड, पूरा ईमेल पता, token या API कुंजी न दिखाएँ। सामान्य लॉग में परीक्षण की पहचान और परिणाम रखें, ईमेल की सामग्री नहीं।

परीक्षण समाप्त होने पर अस्थायी कुंजी रद्द करें और अनावश्यक पहुँच हटाएँ। Mailera में कुंजी रद्द होते ही उससे आने वाले API अनुरोध अस्वीकार हो जाते हैं। पहुँच की व्यवस्था तय करते समय Mailera की सुरक्षा जानकारी देखें।

अगर यही प्रक्रिया किसी AI agent में लगानी है, तो ईमेल को अविश्वसनीय डेटा मानें, निर्देश नहीं। ईमेल में मिले आदेशों पर चलकर कुंजी साझा न करें, अन्य मेलबॉक्स न पढ़ें और कोई कार्रवाई न करें। agent को न्यूनतम अनुमति दें; कोई संदेश भेजना हो तो पहले मानव पुष्टि लें।

इस प्रक्रिया में Mailera की सीमाएँ क्या हैं?

Mailera नया Hotmail खाता, मेलबॉक्स या ईमेल पता नहीं बनाता। आपको पहले से मौजूद अधिकृत मेलबॉक्स जोड़ना होगा। ईमेल से OTP पढ़ लेना उसकी वैधता, समाप्ति समय या ऐप द्वारा स्वीकार किए जाने का प्रमाण नहीं है।

Microsoft के नए संदेश Graph change notifications से आते हैं और साथ में समय-समय पर पृष्ठभूमि में भी जाँच होती है। इसे तत्काल उपलब्धता का वादा न मानें। Mailera Inbox में पहुँचने की गारंटी भी नहीं देता। Junk से संदेश हटाने पर भविष्य के ईमेल की जगह तय नहीं होती।

यह काम API से करें

इस लेख की हर कार्रवाई REST API के ज़रिए उपलब्ध है, साथ में curl के उदाहरण, API key और webhook भी हैं।

API दस्तावेज़ देखें