---
title: "Outlook OTP API: अपने परीक्षण मेलबॉक्स से कोड पढ़ें"
description: "अपने Outlook या Microsoft 365 परीक्षण मेलबॉक्स से Mailera API द्वारा OTP पढ़ें। OAuth, read अनुमति, सही संदेश चुनने और Junk की जाँच का तरीका समझें।"
url: https://mailera.app/hi/blog/outlook-otp-api
published: 2026-10-25
updated: 2026-10-25
---

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

Microsoft OAuth से अपना Outlook या Microsoft 365 मेलबॉक्स जोड़ें और read अनुमति वाली Mailera API कुंजी से सत्यापन कोड पढ़ें। सही संदेश चुनना और ऐप में कोड की वैधता जाँचना अलग चरण हैं।

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

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

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

| काम | किसकी ज़िम्मेदारी है? | परीक्षण में क्या देखें? |
| --- | --- | --- |
| OTP जारी करना और ईमेल भेजना | आपका ऐप या उसकी प्रमाणीकरण सेवा | सही परीक्षण खाते के लिए अनुरोध हुआ हो |
| प्राप्त ईमेल से कोड पढ़ना | Mailera API | सही मेलबॉक्स और संबंधित संदेश चुना गया हो |
| कोड स्वीकार या अस्वीकार करना | कोड जारी करने वाला ऐप | उसी लॉगिन प्रयास में सत्यापन सफल हो |

Microsoft Entra का [emailOtpSend इवेंट](https://learn.microsoft.com/en-us/entra/identity-platform/custom-extension-email-otp-send-data) अलग काम करता है: इवेंट सक्रिय होने पर Entra आपके निर्दिष्ट REST API को कोड भेजता है। यह Outlook इनबॉक्स से कोड पढ़ने वाला endpoint नहीं है।

Mailera में Outlook.com और Microsoft 365 दोनों को Microsoft Graph के ज़रिए जोड़ा जा सकता है। दूसरे प्रदाताओं सहित सामान्य प्रक्रिया के लिए [अपने इनबॉक्स से OTP पढ़ने की गाइड](https://mailera.app/hi/blog/email-otp-api) देखें। यहाँ 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 मेलबॉक्स कनेक्शन पृष्ठ](https://mailera.app/hi/providers/microsoft) समर्थित कनेक्शन का संदर्भ देता है।
3. **सीमित कुंजी बनाएँ।** **सेटिंग्स** में API कुंजी वाले टैब से **API key बनाएँ** खोलें। **मेलबॉक्स का दायरा** परीक्षण मेलबॉक्स वाले समूह तक रखें और केवल `read` अनुमति दें। **समाप्ति** भी तय करें।
4. **कुंजी सुरक्षित रखें।** **API key बन गई — अभी कॉपी करें** आने पर उसे सर्वर के सुरक्षित परिवेश में सहेजें। कुंजी केवल एक बार दिखाई जाती है। उसे ब्राउज़र कोड, स्क्रीनशॉट या लॉग में न डालें।

![Mailera में Outlook मेलबॉक्स जोड़ने के लिए Microsoft से साइन इन करें विकल्प](https://mailera.app/media/ae86847c0646dca2/gmail-mailera-gmail-add-mailbox-hi-1200.jpg)
_Outlook और Microsoft 365 के लिए Microsoft OAuth वाला विकल्प चुनें।_

Microsoft की [उपयोगकर्ता की ओर से पहुँच लेने की प्रक्रिया](https://learn.microsoft.com/en-us/graph/auth-v2-user) में साइन-इन के दौरान ऐप की माँगी गई अनुमतियों के लिए सहमति ली जाती है। Microsoft के [authorization code flow दस्तावेज़](https://learn.microsoft.com/en-us/entra/identity-platform/v2-oauth2-auth-code-flow) के अनुसार कुछ अनुमतियाँ व्यवस्थापक तक सीमित होती हैं। संगठन के खाते पर सहमति अटके तो अपने Microsoft 365 व्यवस्थापक से जाँच कराएँ; ऐप पासवर्ड पर न जाएँ।

पुराने IMAP सेटअप से आ रहे हैं तो [Outlook में ऐप पासवर्ड के बजाय OAuth इस्तेमाल करने की गाइड](https://mailera.app/hi/blog/outlook-app-password-not-working) उपयोगी है। अन्य प्रदाताओं के अंतर [मेलबॉक्स के ऐप पासवर्ड और OAuth की गाइड](https://mailera.app/hi/blog/email-app-password-oauth) में हैं।

![परीक्षण समूह तक सीमित और केवल read अनुमति वाली Mailera API कुंजी की सेटिंग](https://mailera.app/media/1f56e26c5e40a646/outlook-otp-api-read-only-key-hi-1200.jpg)
_OTP पढ़ने के परीक्षण को read अनुमति दें; सिंक या संदेश हटाने-ले जाने की अनुमति अलग है।_

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

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

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

```bash
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 के डेवलपर पृष्ठ](https://mailera.app/hi/developers) पर है। अनुरोध और अनुमतियों के संदर्भ के लिए [API दस्तावेज़](https://mailera.app/hi/docs) इस्तेमाल करें।

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

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

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

```bash
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 के लिए एन्कोड करता है।

| पैरामीटर | इस उदाहरण में दिया गया मान |
| --- | --- |
| `id` | अपने परीक्षण मेलबॉक्स का `$MAILBOX_ID` |
| `from` | परीक्षण ईमेल के प्रेषक का पता |
| `subject` | परीक्षण ईमेल का विषय |
| `since_minutes` | `5` |

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

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

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

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

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

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

| समस्या | क्या जाँचें? | अगला कदम |
| --- | --- | --- |
| गलत खाते का परिणाम | सूची का `email` और चुना हुआ `id` | `$MAILBOX_ID` ठीक करें |
| कनेक्शन टूटा है | `/status` से Microsoft साइन-इन | मेलबॉक्स फिर कनेक्ट करें |
| ईमेल है, पर फ़िल्टर से नहीं मिलता | वास्तविक प्रेषक और विषय | अनुरोध के मान सुधारें |
| पुराना कोड मिल रहा है | संदेश का `received_at` और परीक्षण का समय | पुराने संदेश को छोड़ें; मिलान अस्पष्ट हो तो रोकें |
| Inbox में ईमेल नहीं दिखती | `/placement` और Junk फ़ोल्डर | संदेश का स्थान अलग से जाँचें |
| मेलबॉक्स सिंक नहीं हुआ | `GET /mailboxes` की प्रतिक्रिया का `last_sync_at` और कनेक्शन | ज़रूरत पर अलग `sync` अनुमति से सिंक करें |

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

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

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

```bash
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 का सुरक्षा पृष्ठ](https://mailera.app/hi/security) देखें।

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

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

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

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

**यह काम API से करें** — इस लेख की हर कार्रवाई REST API के ज़रिए उपलब्ध है, साथ में curl के उदाहरण, API key और webhook भी हैं। [API दस्तावेज़ देखें](https://mailera.app/hi/docs)