MailLandDocs
التحقق من البريد

التحقق من بريد إلكتروني واحد

تحقق من صحة عناوين البريد الإلكتروني الفردية في الوقت الفعلي مع فحوصات الصياغة والنطاق وSMTP

تحقق من صحة عنوان بريد إلكتروني في الوقت الفعلي قبل الإرسال. يُجري MailLand سلسلة تحقق من 5 طبقات: فحص الصياغة، اكتشاف الأخطاء الإملائية، كشف النطاقات المؤقتة، كشف الحسابات الوظيفية، والتحقق عبر SMTP.

المصادقة

أدرج مفتاح API الخاص بك في ترويسة X-API-Key:

X-API-Key: ml_pv_Ab3Kx9mN2pQ7rT4wL8yD...

يجب أن يكون الاعتماد اعتماد منتج Validation مع تفعيل قناة Api.

التحقق من بريد إلكتروني

POST https://api.mail.land/v1/validation/email
طلب التحقق
{
  "email": "[email protected]",
  "verify_smtp": true
}
الحقلالنوعالافتراضيالوصف
emailstring-عنوان البريد الإلكتروني للتحقق منه (مطلوب)
verify_smtpbooltrueإجراء التحقق من صندوق البريد عبر SMTP
Validate an email
curl -X POST https://api.mail.land/v1/validation/email \
  -H "X-API-Key: ml_pv_Ab3Kx9mN2pQ7rT4wL8yD..." \
  -H "Content-Type: application/json" \
  -d '{ "email": "[email protected]", "verify_smtp": true }'

الاستجابة

استجابة التحقق
{
  "email": "[email protected]",
  "result": "Deliverable",
  "score": 95,
  "syntax": {
    "is_valid": true,
    "suggestion": null,
    "domain": "example.com",
    "local_part": "user",
    "has_typo": false,
    "typo_type": null,
    "typo_confidence": null
  },
  "disposable": {
    "is_disposable": false
  },
  "role": {
    "is_role_account": false
  },
  "mx": {
    "has_mx": true,
    "records": ["mx1.example.com", "mx2.example.com"],
    "accepts_mail": true
  },
  "smtp": {
    "can_connect": true,
    "is_deliverable": true,
    "is_catch_all": false,
    "has_full_inbox": false,
    "is_disabled": false,
    "reachability": "safe",
    "error_type": null,
    "error_message": null
  },
  "provider": {
    "name": "Unknown",
    "type": "unknown"
  },
  "cached": false,
  "verified_at": "2026-02-17T12:34:56Z"
}

أنواع النتائج

النتيجةنطاق الدرجةالوصف
Deliverable80–95عنوان صالح، تم تأكيد قابلية التسليم عبر SMTP
Risky45–70قد يكون قابلاً للتسليم لكن توجد عوامل خطر (خادم catch-all، حساب وظيفي، صندوق ممتلئ)
Unknown30–50لا يمكن التحديد (انتهاء مهلة SMTP، فشل الاتصال)
Undeliverable0–25غير قابل للتسليم (نطاق مؤقت، لا يوجد سجل MX، صندوق بريد معطّل، صياغة غير صالحة = 0)
Invalid5 (ثابتة)خطأ إملائي عالي الثقة في النطاق (ثقة ≥90%)، راجع syntax.suggestion

تعديلات الدرجة

يتم تعديل الدرجة الأساسية بناءً على عوامل الخطر:

العاملالتعديل
حساب وظيفي (info@، admin@، إلخ.)-10
خادم catch-all-5

سلسلة التحقق

يتحقق MailLand من كل بريد إلكتروني عبر 5 طبقات:

التحقق من الصياغة

يتحقق من التوافق مع معيار RFC 5322: صيغة صالحة، الجزء المحلي (بحد أقصى 64 حرفاً)، النطاق (بحد أقصى 255 حرفاً)، الطول الإجمالي (بحد أقصى 320 حرفاً). كما يكتشف الأخطاء الإملائية الشائعة في النطاقات.

فحص النطاقات المؤقتة

يتحقق من النطاق مقابل قاعدة بيانات لمزودي البريد الإلكتروني المؤقت المعروفين. يتم تصنيف العناوين المؤقتة فوراً كـ Undeliverable.

فحص الحسابات الوظيفية

يكتشف العناوين الوظيفية مثل info@ وadmin@ وsupport@ وpostmaster@. لا يتم تصنيف الحسابات الوظيفية كغير قابلة للتسليم لكنها تُقلل من درجة الثقة.

التحقق من سجلات MX

يبحث عن سجلات MX للنطاق. إذا لم توجد سجلات MX ولا سجل A، يتم تصنيف البريد الإلكتروني كـ Undeliverable.

التحقق عبر SMTP

يتصل بخادم البريد ويتحقق مما إذا كان صندوق البريد موجوداً. يتم تخطي هذه الخطوة إذا كانت قيمة verify_smtp هي false.

اكتشاف الأخطاء الإملائية

يستخدم MailLand نظام اكتشاف أخطاء إملائية من 3 طبقات للأخطاء الشائعة في النطاقات:

الطبقةالطريقةمثال
مطابقة دقيقةقاعدة بيانات الأخطاء المعروفةgmial.com → gmail.com
تصحيح TLDمتغيرات نطاق المستوى الأعلىgmail.co → gmail.com
مسافة Levenshteinمطابقة ضبابية (أقصى مسافة: 2)gmal.com → gmail.com

عند اكتشاف خطأ إملائي، يحتوي حقل syntax.suggestion على العنوان المُصحّح:

تم اكتشاف خطأ إملائي
{
  "email": "[email protected]",
  "result": "Invalid",
  "score": 5,
  "syntax": {
    "is_valid": true,
    "suggestion": "[email protected]",
    "domain": "gmial.com",
    "local_part": "user",
    "has_typo": true,
    "typo_type": "levenshtein",
    "typo_confidence": 95
  }
}

الأخطاء الإملائية عالية الثقة (بنسبة 90%+) يتم تقييمها مبكراً في السلسلة: لا يتم إجراء فحص SMTP ولا يتم استهلاك أي رصيد.

اكتشاف مزود الخدمة

يتعرف MailLand على مزود البريد الإلكتروني من أسماء النطاقات وسجلات MX:

المزودالنوعطريقة الاكتشاف
Gmailconsumerمطابقة النطاق
Outlook / Hotmail / Liveconsumerمطابقة النطاق
Yahooconsumerمطابقة النطاق
iCloudconsumerمطابقة النطاق
ProtonMailconsumerمطابقة النطاق
Google Workspacebusinessسجلات MX (aspmx)
Microsoft 365businessسجلات MX (outlook.com)
Zohobusinessسجلات MX
Mimecastbusinessسجلات MX
Proofpointbusinessسجلات MX

تفاصيل فحص SMTP

يحتوي كائن smtp على نتائج التحقق التفصيلية عبر SMTP:

الحقلالنوعالوصف
can_connectboolتم الاتصال بخادم SMTP بنجاح
is_deliverableboolيبدو أن صندوق البريد موجود
is_catch_allboolالخادم يقبل جميع العناوين (يُقلل الثقة)
has_full_inboxboolصندوق البريد ممتلئ (النتيجة: Risky)
is_disabledboolصندوق البريد معطّل (النتيجة: Undeliverable)
reachabilitystringالحكم: safe أو risky أو invalid أو unknown
error_typestringنوع الخطأ إذا فشل فحص SMTP
error_messagestringرسالة خطأ تفصيلية

أنواع أخطاء SMTP

نوع الخطأالوصف
Timeoutانتهت مهلة اتصال SMTP
ConnectionFailedتعذر الاتصال بالخادم
Blacklistedعنوان IP الخاص بالتحقق محظور من قبل الخادم
Socks5خطأ في البروكسي
AsyncSmtpErrorخطأ في بروتوكول SMTP
Cancelledتم إلغاء الطلب
UnexpectedErrorخطأ غير متوقع

الأرصدة

كل عملية تحقق تستهلك رصيداً واحداً من حصتك الشهرية. بعض عمليات التحقق مجانية (لا يتم استهلاك رصيد):

الحالةمجاني
نطاقات البريد الإلكتروني المؤقتةنعم
أخطاء إملائية عالية الثقة في النطاق (90%+)نعم
أخطاء SMTP (انتهاء المهلة، فشل الاتصال، الحظر)نعم
تعذر اتصال SMTP مع نتيجة غير معروفةنعم
النتائج المخزنة مؤقتاًلا (تم استهلاك الرصيد عند الفحص الأول)

تحقق من رصيدك:

GET https://api.mail.land/v1/validation/credits
رصيد الأرصدة
{
  "monthly_quota": 1000,
  "used": 450,
  "remaining": 550,
  "resets_at": "2026-03-01T00:00:00Z"
}

تُعاد تعيين الأرصدة تلقائياً في اليوم الأول من كل شهر (بتوقيت UTC).

التخزين المؤقت

يتم تخزين نتائج التحقق مؤقتاً في Redis لتجنب الفحوصات المتكررة:

نوع النتيجةمدة التخزين المؤقت
Deliverable48 ساعة
Risky24 ساعة
Undeliverable24 ساعة
Unknown6 ساعات

تحتوي الاستجابات المخزنة مؤقتاً على cached: true في الاستجابة. تم استهلاك الرصيد الأصلي عند حساب النتيجة لأول مرة.

استجابات الأخطاء

الحالةالكودالوصف
400INVALID_REQUESTنص الطلب مفقود أو غير صالح
400INVALID_EMAIL_FORMATعنوان البريد الإلكتروني مطلوب
402INSUFFICIENT_CREDITSتم تجاوز حصة التحقق الشهرية

الخطوات التالية

في هذه الصفحة