> ## 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 لرموز مخاطر التحقق من البريد الإلكتروني: البريد المخترق، والمؤقت، وغير القابل للتسليم، وقائمة الحظر، وحدود OTP.

تُصدِر ميزة التحقق من البريد الإلكتروني **تحذيرات** كلما ظهرت إشارة مخاطر أثناء مسار OTP أو على العنوان نفسه: مثل حدوث تسريب بيانات معروف، أو استخدام مزود مؤقت، أو عدم إمكانية تسليم الرسائل إلى صندوق البريد، أو تجاوز الحد الأقصى لمحاولات OTP، أو وجود تطابق مع قائمة الحظر لديك أو مع عملية تحقق مقبولة أخرى. توضح هذه الصفحة جميع الرموز، ومسببات إطلاقها، وكيفية إعداد استجابة سير العمل.

## نظرة عامة

تُصنَّف التحذيرات بالميزة `EMAIL`. وتظهر في التقرير ضمن `email_verifications[].warnings[]` وتتبع البنية القياسية لـ [كائن التحذير](https://docs.didit.me/ar/reference/data-models.md#كائن-التحذير) (`feature` و`risk` و`additional_data` و`log_type` و`short_description` و`long_description` و`node_id`). كما يُوجَّه كل تحذير أيضاً إلى سجل الجلسة ليظهر في Business Console ضمن قسم البريد الإلكتروني.

تُعد بعض التحذيرات مسببات **رفض تلقائي صارم** — حيث تضبط دائماً حالة الميزة إلى `Declined` وتحمل `log_type: "error"`. بينما ترتبط التحذيرات الأخرى بـ **إجراء قابل للإعداد** (`DECLINE`، أو `REVIEW`، أو الإجراء الافتراضي `NO_ACTION`) يتم تحديده لكل عقدة سير عمل أو لكل استدعاء API، مما يتيح لنفس رمز المخاطر رفض سير عمل معين مع الاكتفاء بوضع علامة تنبيه في سير عمل آخر. كما يحدد الإجراء المُعدّ مستوى الخطورة: `DECLINE` → `error`، و`REVIEW` → `warning`، و`NO_ACTION` → `information`.

## شروط الرفض التلقائي

تؤدي التحذيرات التالية دائماً إلى رفض خطوة التحقق من البريد الإلكتروني بغض النظر عن الإعدادات:

* `EMAIL_CODE_ATTEMPTS_EXCEEDED` — استنفد المستخدم المحاولات المتاحة لرمز OTP: محاولتان لإدخال رمز غير صحيح (`email_max_check_attempts`) أو عمليتا إرسال لرمز OTP — الإرسال الأولي بالإضافة إلى إعادة إرسال واحدة (`email_max_retries`) — وفق الإعدادات الافتراضية.
* `EMAIL_IN_BLOCKLIST` — العنوان مدرج في قائمة الحظر المُدارة عبر [Lists API](https://docs.didit.me/ar/management-api/lists/overview.md)، أو تطابق مع عملية تحقق سابقة مقبولة من البريد الإلكتروني تم إدراجها في قائمة الحظر.
* `UNDELIVERABLE_EMAIL_DETECTED` — تعذر تسليم الرسائل إلى العنوان: صيغة غير صالحة، أو نطاق غير موجود، أو غياب سجلات DNS (MX)، أو تعذر تسليم بريد OTP الإلكتروني. تكتمل الخطوة بالحالة `Declined` فوراً — دون تشغيل أي فحص للرمز. استثناء: عندما يُدخل المستخدم العنوان بنفسه (لم يكن معبأً مسبقاً عند إنشاء الجلسة)، فإن تعذر الإرسال يُرجع خطأً مضمناً يظهر للمستخدم ليتمكن من إعادة المحاولة باستخدام عنوان مختلف بدلاً من الرفض.

## المخاطر القابلة للإعداد

يرتبط كل خطر من المخاطر التالية بإعداد (لكل عقدة سير عمل، أو لكل استدعاء على [endpoint التحقق](https://docs.didit.me/ar/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/ar/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/ar/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/ar/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/ar/core-technology/email-verification/overview.md) — سلوك الميزة والأسعار.
* [تقرير التحقق من البريد الإلكتروني](https://docs.didit.me/ar/core-technology/email-verification/report-email-verification.md) — هيكل الاستجابة الكامل بما في ذلك `lifecycle[]` و`matches[]`.
* [نماذج البيانات — التحقق من البريد الإلكتروني](https://docs.didit.me/ar/reference/data-models.md#التحقق-من-البريد-الإلكتروني) — المخطط القياسي حقلاً بحقل.
* [Management API — القوائم](https://docs.didit.me/ar/management-api/lists/overview.md) — إدارة قائمة حظر البريد الإلكتروني المستخدمة بواسطة `EMAIL_IN_BLOCKLIST`.


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