Outlook OTP API: अपने परीक्षण मेलबॉक्स से कोड पढ़ें

OTP भेजना और Outlook में आया कोड पढ़ना अलग काम हैं

आपके ऐप ने सत्यापन ईमेल भेज दिया है। अब लॉगिन परीक्षण को उसी ईमेल का कोड चाहिए, किसी पुराने संदेश का नहीं। यहाँ Outlook OTP API का मतलब Mailera के ज़रिए अपने मौजूदा Outlook मेलबॉक्स में आया कोड पढ़ना है।

OTP एक बार इस्तेमाल के लिए जारी किया गया सत्यापन कोड है। परीक्षण में इसके तीन अलग चरण रखें:

Microsoft Entra का emailOtpSend इवेंट अलग काम करता है: इवेंट सक्रिय होने पर Entra आपके निर्दिष्ट REST API को कोड भेजता है। यह Outlook इनबॉक्स से कोड पढ़ने वाला endpoint नहीं है।

Mailera में Outlook.com और Microsoft 365 दोनों को Microsoft Graph के ज़रिए जोड़ा जा सकता है। दूसरे प्रदाताओं सहित सामान्य प्रक्रिया के लिए अपने इनबॉक्स से OTP पढ़ने की गाइड देखें। यहाँ Microsoft कनेक्शन और उससे जुड़े API अनुरोध बताए गए हैं।

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

Microsoft OAuth और Mailera API कुंजी को अलग समझें। OAuth से Mailera को आपका Microsoft मेलबॉक्स जोड़ने की अनुमति मिलती है। API कुंजी से आपका परीक्षण प्रोग्राम Mailera API को अनुरोध भेजता है।

1. मेलबॉक्स जोड़ें। Admin या Leader भूमिका से मेलबॉक्स → मेलबॉक्स जोड़ें खोलें। Microsoft से साइन इन करें चुनें और Microsoft पर अपने परीक्षण खाते से OAuth सहमति पूरी करें। इस प्रक्रिया में ऐप पासवर्ड (app password) इस्तेमाल नहीं होता।
2. परीक्षण खाता तय करें। व्यक्तिगत खाते के बजाय अपने अधिकृत परीक्षण का मेलबॉक्स चुनें। कुंजी बनाने के बाद नीचे दिए गए GET /mailboxes अनुरोध की प्रतिक्रिया में email, status और last_sync_at देखें। Microsoft मेलबॉक्स कनेक्शन पृष्ठ समर्थित कनेक्शन का संदर्भ देता है।
3. सीमित कुंजी बनाएँ। सेटिंग्स में API कुंजी वाले टैब से API key बनाएँ खोलें। मेलबॉक्स का दायरा परीक्षण मेलबॉक्स वाले समूह तक रखें और केवल read अनुमति दें। समाप्ति भी तय करें।
4. कुंजी सुरक्षित रखें। API key बन गई — अभी कॉपी करें आने पर उसे सर्वर के सुरक्षित परिवेश में सहेजें। कुंजी केवल एक बार दिखाई जाती है। उसे ब्राउज़र कोड, स्क्रीनशॉट या लॉग में न डालें।

Microsoft की उपयोगकर्ता की ओर से पहुँच लेने की प्रक्रिया में साइन-इन के दौरान ऐप की माँगी गई अनुमतियों के लिए सहमति ली जाती है। Microsoft के authorization code flow दस्तावेज़ के अनुसार कुछ अनुमतियाँ व्यवस्थापक तक सीमित होती हैं। संगठन के खाते पर सहमति अटके तो अपने Microsoft 365 व्यवस्थापक से जाँच कराएँ; ऐप पासवर्ड पर न जाएँ।

पुराने IMAP सेटअप से आ रहे हैं तो Outlook में ऐप पासवर्ड के बजाय OAuth इस्तेमाल करने की गाइड उपयोगी है। अन्य प्रदाताओं के अंतर मेलबॉक्स के ऐप पासवर्ड और OAuth की गाइड में हैं।

सही मेलबॉक्स से नया OTP कैसे माँगें?

नीचे के अनुरोध सर्वर या निजी परीक्षण परिवेश में चलाएँ। $MAILERA_API_KEY में अपनी कुंजी रखें। पहले अनुरोध से सही मेलबॉक्स का id पहचानकर उसे $MAILBOX_ID में रखें। API का आधार URL https://mailera.app/api/public/v1 है और प्रमाणीकरण के लिए Authorization: Bearer header चाहिए।

1. मेलबॉक्स की पहचान करें

curl --get 'https://mailera.app/api/public/v1/mailboxes' \
  --header "Authorization: Bearer $MAILERA_API_KEY" \
  --data-urlencode 'provider=microsoft'

प्रतिक्रिया के data में email, id, group_id, status और last_sync_at देखें। सूची का पहला खाता अपने-आप न चुनें। पता अपने परीक्षण खाते से मिलाएँ; परिणाम कई पृष्ठों में हों तो limit और offset से आगे की सूची लें।

REST एकीकरण का परिचय Mailera के डेवलपर पृष्ठ पर है। अनुरोध और अनुमतियों के संदर्भ के लिए API दस्तावेज़ इस्तेमाल करें।

2. अपने ऐप में नया सत्यापन अनुरोध शुरू करें

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

3. OTP endpoint को अनुरोध भेजें

curl --get "https://mailera.app/api/public/v1/mailboxes/$MAILBOX_ID/otp" \
  --header "Authorization: Bearer $MAILERA_API_KEY" \
  --data-urlencode 'from=verification@example.com' \
  --data-urlencode 'subject=Your verification code' \
  --data-urlencode 'since_minutes=5'

verification@example.com और विषय केवल उदाहरण हैं। इन्हें अपने ऐप के वास्तविक प्रेषक और संदेश के विषय से बदलें। --data-urlencode पैरामीटर को URL के लिए एन्कोड करता है।

केवल अनुरोध के पैरामीटर के आधार पर किसी संदेश को वर्तमान परीक्षण का न मानें। संदेश की पहचान अलग से जाँचें।

4. संदेश की पहचान जाँचकर ही कोड ऐप को दें

संबंधित संदेश देखने के लिए GET /mailboxes/{id}/messages से फ़ोल्डर के संदेश लें। प्रतिक्रिया में from.address, subject और received_at देखें। received_at को दर्ज किए गए परीक्षण समय से मिलाएँ और प्रेषक तथा विषय भी जाँचें। सिर्फ़ पहले परिणाम पर निर्भर न रहें।

एक से अधिक संदेश वर्तमान परीक्षण से मेल खाते हों तो मनमाना कोड चुनने के बजाय परीक्षण रोकें। स्पष्ट मिलान मिलने पर ही प्राप्त कोड को उसी परीक्षण ऐप के सत्यापन चरण में दें। कोड मिलना परीक्षण की सफलता नहीं है; सफलता ऐप द्वारा उसे स्वीकार करने पर तय करें।

आम गलतियाँ: OTP नहीं मिले या गलत कोड मिले तो क्या करें?

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

Microsoft साइन-इन की सीधी जाँच:

curl "https://mailera.app/api/public/v1/mailboxes/$MAILBOX_ID/status" \
  --header "Authorization: Bearer $MAILERA_API_KEY"

संदेश Inbox या Spam में पहुँचा है या नहीं, इसके लिए अलग अनुरोध:

curl --get "https://mailera.app/api/public/v1/mailboxes/$MAILBOX_ID/placement" \
  --header "Authorization: Bearer $MAILERA_API_KEY" \
  --data-urlencode 'from=verification@example.com' \
  --data-urlencode 'subject=Your verification code' \
  --data-urlencode 'since_minutes=5'

स्थान की जाँच और कोड निकालने को अलग चरण रखें। Junk में संदेश मिले तो उसका प्रेषक, विषय और समय देखकर आगे बढ़ें। उसे बाहर ले जाने के लिए move अनुमति चाहिए। POST /mailboxes/{id}/sync के लिए अलग sync अनुमति चाहिए; केवल read वाली कुंजी से दोनों काम नहीं होंगे।

पुनःप्रयासों की संख्या और कुल प्रतीक्षा सीमा अपने परीक्षण में तय करें। ईमेल आने में देरी को API अनुरोध की त्रुटि से अलग दर्ज करें। Mailera नई Microsoft ईमेल के लिए Graph change notifications इस्तेमाल करता है और बैकग्राउंड जाँच भी करता है; परीक्षण की सफलता इस पर निर्भर न रखें कि ईमेल किसी तय समय पर ही आएगा।

परीक्षण के दौरान पहुँच और OTP सुरक्षित कैसे रखें?

केवल अपने परीक्षण खाते और अपने ऐप के अधिकृत लॉगिन प्रयास इस्तेमाल करें। API कुंजी, OAuth token, ईमेल पता और OTP को स्क्रीनशॉट तथा लॉग में छिपाएँ। पूरी API प्रतिक्रिया लॉग करने से संदेश और कोड दोनों बाहर जा सकते हैं; परीक्षण रिपोर्ट में कोड स्थायी रूप से न रखें।

कुंजी का दायरा परीक्षण समूह तक रखें। पढ़ने वाले परीक्षण को send या manage अनुमति न दें। काम समाप्त होने पर कुंजी रद्द करें; Mailera में रद्द कुंजी के अनुरोध तुरंत अस्वीकार होते हैं। पहुँच की समीक्षा के लिए Mailera का सुरक्षा पृष्ठ देखें।

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

Mailera की सीमाएँ कहाँ हैं?

Mailera पहले से मौजूद मेलबॉक्स जोड़ता है; नया Outlook ईमेल पता नहीं बनाता। कोड मिल जाने से यह पुष्टि नहीं होती कि वह कितनी देर और मान्य रहेगा या ऐप उसे स्वीकार करेगा। वह निर्णय कोड जारी करने वाला ऐप करता है।

Mailera Inbox में पहुँचने का वादा नहीं करता। Junk से संदेश हटाना प्रदाता को उस प्रेषक पर भरोसा करने के लिए बाध्य नहीं करता। Mailera Microsoft का आधिकारिक साझेदार होने का दावा भी नहीं करता।