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
Validation request
{
  "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 }'

پاسخ

Validation response
{
  "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 حاوی آدرس تصحیح شده است:

Typo detected
{
  "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عدم امکان اتصال به سرور
BlacklistedIP اعتبارسنجی توسط سرور مسدود شده
Socks5خطای پروکسی
AsyncSmtpErrorخطای پروتکل SMTP
Cancelledدرخواست لغو شد
UnexpectedErrorخطای غیرمنتظره

اعتبارها

هر اعتبارسنجی یک اعتبار از سهمیه ماهانه شما مصرف می‌کند. برخی اعتبارسنجی‌ها رایگان هستند (بدون مصرف اعتبار):

شرایطرایگان
دامنه‌های ایمیل یکبار مصرفبله
اشتباهات تایپی دامنه با اطمینان بالا (بیش از 90%)بله
خطاهای SMTP (وقفه، خرابی اتصال، مسدود شده)بله
عدم امکان اتصال SMTP با نتیجه نامشخصبله
نتایج کش شدهخیر (اعتبار در بررسی اول مصرف شده)

بررسی موجودی اعتبار:

GET https://api.mail.land/v1/validation/credits
Credit balance
{
  "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سهمیه ماهانه اعتبارسنجی تمام شده

مراحل بعدی

در این صفحه