> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# ईमेल सत्यापन चेतावनियाँ और जोखिम कोड

> Didit ईमेल सत्यापन के सभी जोखिम कोड का संदर्भ: BREACHED_EMAIL_DETECTED, DISPOSABLE_EMAIL_DETECTED, ब्लॉकलिस्ट और OTP सीमाएं।

ईमेल सत्यापन सुविधा तब **चेतावनियाँ** उत्सर्जित करती है जब OTP फ़्लो या स्वयं पते पर कोई जोखिम संकेत ट्रिगर होता है: एक ज्ञात डेटा ब्रीच, एक डिस्पोजेबल प्रदाता, एक अनडिलीवरेबल मेलबॉक्स, एक OTP प्रयास सीमा, या आपकी ब्लॉकलिस्ट या किसी अन्य स्वीकृत सत्यापन के विरुद्ध कोई हिट। यह पेज प्रत्येक कोड, इसे क्या ट्रिगर करता है, और वर्कफ़्लो रिस्पॉन्स को कैसे कॉन्फ़िगर करें, यह सूचीबद्ध करता है।

## अवलोकन

चेतावनियों को सुविधा `EMAIL` के साथ टैग किया जाता है। वे रिपोर्ट पर `email_verifications[].warnings[]` के अंतर्गत दिखाई देती हैं और मानक [चेतावनी ऑब्जेक्ट](https://docs.didit.me/hi/reference/data-models.md#चेतावनी-ऑब्जेक्ट) के आकार (`feature`, `risk`, `additional_data`, `log_type`, `short_description`, `long_description`, `node_id`) का पालन करती हैं। प्रत्येक चेतावनी को प्रति-सत्र लॉग में भी रूट किया जाता है ताकि यह Business Console में Email अनुभाग के अंतर्गत दिखाई दे।

कुछ चेतावनियाँ **हार्ड ऑटो-अस्वीकृति** ट्रिगर हैं — वे हमेशा सुविधा स्थिति को `Declined` पर सेट करती हैं और उनमें `log_type: "error"` होता है। अन्य प्रति वर्कफ़्लो नोड या प्रति API कॉल परिभाषित एक **कॉन्फ़िगर करने योग्य कार्रवाई** (`DECLINE`, `REVIEW`, या डिफ़ॉल्ट `NO_ACTION`) पर मैप होती हैं, इसलिए वही जोखिम कोड एक वर्कफ़्लो को अस्वीकार कर सकता है जबकि दूसरे को केवल फ़्लैग कर सकता है। कॉन्फ़िगर की गई कार्रवाई गंभीरता भी सेट करती है: `DECLINE` → `error`, `REVIEW` → `warning`, `NO_ACTION` → `information`।

## ऑटो-अस्वीकृति की शर्तें

निम्नलिखित चेतावनियाँ कॉन्फ़िगरेशन की परवाह किए बिना ईमेल सत्यापन चरण को हमेशा अस्वीकार करती हैं:

* `EMAIL_CODE_ATTEMPTS_EXCEEDED` — उपयोगकर्ता ने OTP बजट समाप्त कर दिया: डिफ़ॉल्ट रूप से 2 गलत कोड प्रविष्टियाँ (`email_max_check_attempts`) या 2 OTP भेजना — प्रारंभिक भेजना और एक पुनः भेजना (`email_max_retries`)।
* `EMAIL_IN_BLOCKLIST` — पता [Lists API](https://docs.didit.me/hi/management-api/lists/overview.md) के माध्यम से प्रबंधित ब्लॉकलिस्ट में है, या पहले से स्वीकृत ईमेल सत्यापन से मेल खाता है जिसे ब्लॉकलिस्ट किया गया था।
* `UNDELIVERABLE_EMAIL_DETECTED` — पता मेल प्राप्त नहीं कर सकता: अमान्य सिंटैक्स, अस्तित्वहीन डोमेन, DNS (MX) रिकॉर्ड का न होना, या OTP ईमेल डिलीवर नहीं किया जा सका। चरण तुरंत `Declined` के रूप में अंतिम रूप ले लेता है — कोई कोड जांच कभी नहीं चलती है। अपवाद: जब उपयोगकर्ता ने स्वयं पता टाइप किया हो (यह सत्र निर्माण के समय पहले से भरा नहीं गया था), तो डिलीवरी विफल होने पर भेजने का प्रयास एक इनलाइन त्रुटि लौटाता है ताकि वे अस्वीकृत होने के बजाय किसी भिन्न पते के साथ पुनः प्रयास कर सकें।

## कॉन्फ़िगर करने योग्य जोखिम

निम्नलिखित प्रत्येक जोखिम एक सेटिंग (प्रति वर्कफ़्लो नोड, या स्टैंडअलोन [जाँच endpoint](https://docs.didit.me/hi/standalone-apis/email-check.md) पर प्रति कॉल) पर मैप होता है जिसे आप `DECLINE`, `REVIEW`, या `NO_ACTION` पर कॉन्फ़िगर कर सकते हैं:

| सेटिंग | जोखिम कोड | डिफ़ॉल्ट व्यवहार |
| - | - | - |
| `breached_email_action` | `BREACHED_EMAIL_DETECTED` | `NO_ACTION` — स्थिति बदले बिना `information` स्तर पर ब्रीच विवरण दिखाएं। |
| `disposable_email_action` | `DISPOSABLE_EMAIL_DETECTED` | `NO_ACTION` — स्थिति बदले बिना `information` स्तर पर डिस्पोजेबल प्रदाता को फ़्लैग करें। |
| `duplicated_email_action` | `DUPLICATED_EMAIL` | `NO_ACTION` — `information` स्तर पर डुप्लिकेट रिकॉर्ड करें। जब पता अनुमति सूची में हो तो छोड़ दिया जाता है। |

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

## सत्यापन प्रयास सीमाएँ

ईमेल सत्यापन सुविधा दुरुपयोग को रोकने के लिए OTP प्रयासों पर एक सख्त सीमा लागू करती है:

* **कोड-प्रविष्टि प्रयास** — `email_max_check_attempts`, डिफ़ॉल्ट **2**: दूसरा गलत (या समय-सीमा समाप्त) कोड चरण को अंतिम रूप देता है।
* **भेजने के प्रयास** — `email_max_retries`, डिफ़ॉल्ट रूप से कुल **2** बार भेजना (प्रारंभिक भेजना और एक बार पुनः भेजना): आगे पुनः भेजने का अनुरोध चरण को अंतिम रूप देता है।

किसी भी सीमा को पार करने पर `EMAIL_CODE_ATTEMPTS_EXCEEDED` उत्पन्न होता है और चरण ऑटो-अस्वीकृत हो जाता है। आप प्रति वर्कफ़्लो नोड दोनों सीमाओं को ट्यून कर सकते हैं।

## उत्पन्न चेतावनियाँ

| टैग | गंभीरता | विवरण |
| - | - | - |
| `EMAIL_CODE_ATTEMPTS_EXCEEDED` | `error` | उपयोगकर्ता कोड-प्रविष्टि या भेजने की सीमा पार कर गया। स्वतः अस्वीकृत होता है। |
| `EMAIL_IN_BLOCKLIST` | `error` | पता [Lists API](https://docs.didit.me/hi/management-api/lists/overview.md) के माध्यम से बनाई गई ब्लॉकलिस्ट में मौजूद है, या ब्लॉकलिस्टेड स्वीकृत सत्यापन से मेल खाता है। स्वतः अस्वीकृत होता है। `additional_data` में `blocklisted_session_id`, `blocklisted_session_number` और `api_service` शामिल होते हैं (शुद्ध सूची मिलान के लिए सभी `null`)। |
| `EMAIL_IN_ALLOWLIST` | `information` | पता [Lists API](https://docs.didit.me/hi/management-api/lists/overview.md) के माध्यम से बनाई गई अनुमति सूची से मेल खाता है, इसलिए डुप्लिकेट-ईमेल कार्रवाई छोड़ दी गई थी। |
| `BREACHED_EMAIL_DETECTED` | `breached_email_action` के अनुसार (डिफ़ॉल्ट रूप से `information`) | पता एक या अधिक ज्ञात डेटा उल्लंघनों में पाया गया था। रिपोर्ट पर `breaches[]` ऐरे में उल्लंघन की गई सेवा, तिथि और डेटा श्रेणियां शामिल होती हैं। |
| `DISPOSABLE_EMAIL_DETECTED` | `disposable_email_action` के अनुसार (डिफ़ॉल्ट रूप से `information`) | डोमेन एक ज्ञात डिस्पोज़ेबल / थ्रोअवे प्रदाता है जिसका उपयोग अक्सर ट्रैसेबिलिटी से बचने के लिए किया जाता है। |
| `UNDELIVERABLE_EMAIL_DETECTED` | `error` | पता मेल प्राप्त नहीं कर सकता (अमान्य सिंटैक्स, गैर-मौजूद डोमेन, अनुपलब्ध MX रिकॉर्ड, या विफल डिलीवरी)। स्वतः अस्वीकृत होता है। |
| `DUPLICATED_EMAIL` | `duplicated_email_action` के अनुसार (डिफ़ॉल्ट रूप से `information`) | पता किसी अन्य अंतिम उपयोगकर्ता (`vendor_data` द्वारा समूहीकृत) के पहले से स्वीकृत ईमेल सत्यापन से मेल खाता है। `additional_data` में `duplicated_session_id`, `duplicated_session_number` और `api_service` शामिल होते हैं। |

प्रति प्रयास `EMAIL_IN_BLOCKLIST`, `DUPLICATED_EMAIL` और `EMAIL_IN_ALLOWLIST` में से अधिकतम एक ही ट्रिगर होता है — ब्लॉकलिस्ट को डुप्लिकेट पर प्राथमिकता मिलती है, और डुप्लिकेट को अनुमति सूची पर प्राथमिकता मिलती है।

## क्रॉस-सत्र मिलान

जब कोई पता पहले से स्वीकृत ईमेल सत्यापनों में या आपकी ब्लॉकलिस्ट में पाया जाता है, तो वे मिलान `email_verifications[].matches[]` के तहत भी दिखाई देते हैं (अधिकतम 5 प्रविष्टियाँ)। प्रत्येक मिलान में `session_id`, `session_number`, `vendor_data`, `verification_date`, `email`, `status`, `is_blocklisted`, `api_service` शामिल होते हैं, और इसमें `source` का मान `session` (एक अन्य स्वीकृत सत्यापन) या `list_entry` (एक ब्लॉकलिस्ट प्रविष्टि) होता है। यदि वर्तमान पता आपकी ईमेल अनुमति सूची पर है, तो Didit मिलान साक्ष्य रखता है लेकिन डुप्लिकेट-ईमेल कार्रवाई लागू करने के बजाय `EMAIL_IN_ALLOWLIST` जारी करता है। संपूर्ण मिलान स्कीमा के लिए [ईमेल सत्यापन रिपोर्ट](https://docs.didit.me/hi/core-technology/email-verification/report-email-verification.md#क्रॉस-सत्र-मिलान) देखें।

## उदाहरण

```json theme={null}
{
  "warnings": [
    {
      "feature": "EMAIL",
      "risk": "EMAIL_IN_BLOCKLIST",
      "additional_data": {
        "blocklisted_session_id": null,
        "blocklisted_session_number": null,
        "api_service": null
      },
      "log_type": "error",
      "short_description": "Email in blocklist",
      "long_description": "The system detected that the email is in the blocklist, which is not allowed.",
      "node_id": "feature_email_1"
    },
    {
      "feature": "EMAIL",
      "risk": "DISPOSABLE_EMAIL_DETECTED",
      "additional_data": null,
      "log_type": "information",
      "short_description": "Disposable email detected",
      "long_description": "The system detected that the email is disposable, which is not allowed.",
      "node_id": "feature_email_1"
    }
  ]
}
```

## चेतावनी के प्रकार

प्रत्येक जोखिम को आपके एप्लिकेशन के कॉन्फ़िगरेशन के आधार पर एक गंभीरता सौंपी जाती है। गंभीरताएँ तीन श्रेणियों में आती हैं:

## संबंधित

* [ईमेल सत्यापन अवलोकन](https://docs.didit.me/hi/core-technology/email-verification/overview.md) — सुविधा का व्यवहार और मूल्य निर्धारण।
* [ईमेल सत्यापन रिपोर्ट](https://docs.didit.me/hi/core-technology/email-verification/report-email-verification.md) — `lifecycle[]` और `matches[]` सहित संपूर्ण रिस्पॉन्स संरचना।
* [डेटा मॉडल — ईमेल सत्यापन](https://docs.didit.me/hi/reference/data-models.md#ईमेल-सत्यापन) — विहित फ़ील्ड-दर-फ़ील्ड स्कीमा।
* [प्रबंधन API — सूचियाँ](https://docs.didit.me/hi/management-api/lists/overview.md) — `EMAIL_IN_BLOCKLIST` द्वारा उपयोग की जाने वाली ईमेल ब्लॉकलिस्ट को प्रबंधित करें।


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.