ما هي واجهة برمجة التطبيقات للتحقق من البريد الإلكتروني؟

تسمح لك واجهة برمجة التطبيقات للتحقق من البريد الإلكتروني بالتحقق من عناوين البريد الإلكتروني في الوقت الفعلي عبر طلب GET. تتحقق من الصياغة، سجلات MX، القوائم السوداء، وتجري التحقق عبر SMTP.

كيف يمكنني المصادقة باستخدام واجهة برمجة التطبيقات؟

يجب عليك تقديم مفتاح API صالح تم إنشاؤه من لوحة التحكم الخاصة بك في EmailVerify.io. الطلبات بدون مفتاح أو بمفتاح غير صالح ستفشل.

ما الفحوصات التي يتم إجراؤها أثناء التحقق من البريد الإلكتروني؟

تشمل الفحوصات التحقق بواسطة التعبيرات النمطية (regex)، البحث في سجلات MX، التحقق من القوائم السوداء لسجلات MX، والتحقق من صندوق البريد على مستوى SMTP.

ما رسائل الخطأ التي يمكن أن ترجعها واجهة برمجة التطبيقات؟

تشمل الأخطاء الشائعة: مفتاح API غير صالح، طلب غير صالح، لا توجد أرصدة متبقية، ويرجى المحاولة مرة أخرى عند مواجهة الخادم لمشكلة.

هل يمكنني التحقق من الأرصدة المتبقية عبر واجهة برمجة التطبيقات؟

نعم. يتيح لك نقطة النهاية /check-account-balance/ التحقق من حالة API، الحدود اليومية، أرصدة الإحالة، والأرصدة المتبقية.

توثيق واجهة برمجة تطبيقات التحقق من البريد الإلكتروني

إرشادات التحقق الفوري

المقدمة

مرحبًا بك في واجهة برمجة تطبيقات التحقق من البريد الإلكتروني الفردي من EmailVerify.io! تتيح لك هذه الواجهة التحقق من بريد إلكتروني واحد في الوقت الفعلي من خلال طلب بسيط، مما يضمن الدقة والموثوقية لاتصالاتك البريدية.

المصادقة

للوصول إلى واجهة API، تحتاج إلى مفتاح API صالح. يمكنك إنشاء مفتاح الـ API الخاص بك من قسم API بعد تسجيل الدخول إلى حسابك. هذا المفتاح مطلوب للمصادقة ولتنفيذ الطلبات بشكل آمن.

نقطة النهاية API

تحقق من صحة بريد إلكتروني واحد عن طريق استبدال الرموز بالمفتاح الفريد الخاص بك والبريد الإلكتروني المطلوب التحقق منه في الرابط التالي:

رابط طلب GET (HTTPS)

https://app.emailverify.io/api/v1/[email protected]

مثال على استجابة ناجحة

ستحصل على استجابة مثل هذه إذا تمت معالجة طلب البريد الإلكتروني الواحد بنجاح:

الرابط

{
  "email": "[email protected]",
  "status": "valid",
  "sub_status": "permitted"
}

الفحوصات التي يتم تنفيذها في التحقق الفردي

التحقق عبر Regex: التحقق من بنية البريد الإلكتروني باستخدام أنماط Regex القياسية للعثور على الأخطاء الإملائية وأخطاء التنسيق قبل المتابعة.

التحقق من سجلات MX: التحقق من وجود سجلات MX للتأكد من أن النطاق مهيأ لاستقبال الرسائل وأنه موجود ونشط.

التحقق من القوائم السوداء MX: التعرف على النطاقات المدرجة في القوائم السوداء المعروفة بالبريد العشوائي أو الأنشطة الضارة لتجنب الوجهات غير الموثوقة.

التحقق عبر SMTP: إجراء تحقق مباشر من خلال التواصل مع خادم SMTP الخاص بالمستلم للتأكد من أن البريد الإلكتروني موجود ويمكنه استقبال الرسائل.

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

رسالة الخطأ

الوصف

مفتاح API غير صالح

عندما يكون المفتاح معطلاً أو غير موجود

طلب غير صالح

وجود معلمات غير صحيحة في رابط واجهة API

لا توجد أرصدة متبقية

لا يملك المستخدم أي اعتمادات

يرجى المحاولة مرة أخرى

عند حدوث خطأ من جانب الخادم لدينا

التحقق من اعتمادات الحساب

يرجى استخدام طلب GET التالي للتحقق من الاعتمادات الحالي (الأرصدة اليومية والفورية المتبقية).

رابط GET (HTTPS):

https://app.emailverify.io/api/v1/check-account-balance/?key=<Your_API_Key>

استبدل <Your_API_Key> بمفتاح API الفعّال الخاص بك.

الاستجابة (JSON):

{
  "api_status": "enabled",
  "daily_credits_limit": 150,
  "referral_credits": 100,
  "remaining_credits": 15000
}

إرشادات التحقق الجماعي

المقدمة

مرحبًا بك في واجهة برمجة تطبيقات التحقق الجماعي من البريد الإلكتروني EmailVerify.io! تتيح لك هذه الواجهة التحقق من ما يصل إلى 5000 عنوان بريد إلكتروني في الوقت الفعلي من خلال طلب بسيط، مما يضمن الدقة والموثوقية في اتصالات البريد الإلكتروني الخاصة بك.

تتيح لك هذه النقطة إرسال دفعات تصل إلى 5000 بريد إلكتروني في المرة الواحدة. إذا كنت ترغب في التحقق من بريد إلكتروني واحد فقط، يرجى استخدام نقطة التحقق الفردي.

المصادقة

للوصول إلى واجهة API، ستحتاج إلى مفتاح API صالح. قم بإنشاء مفتاحك الشخصي من قسم API بعد تسجيل الدخول إلى حسابك. هذا المفتاح مطلوب للمصادقة ولتنفيذ الطلبات بشكل آمن.

نقطة النهاية API

تحقق من عنوان بريد إلكتروني واحد عن طريق استبدال البيانات المطلوبة بمفتاح API الفريد الخاص بك والبريد الإلكتروني المطلوب التحقق منه في الرابط التالي:

رابط طلب POST (HTTPS)

https://app.emailverify.io/api/v1/validate-batch

طلب POST

يمكنك التحقق من ما يصل إلى 5000 عنوان بريد إلكتروني عن طريق إرسالها من خلال طلب POST التالي.

طلب POST

{
  "title": "Task Name",
  "key": "Your_API_Key",
  "email_batch": [
    { "address": "[email protected]" },
    { "address": "[email protected]" },
    { "address": "[email protected]" }
  ]
}

مثال على استجابة ناجحة

ستتلقى استجابة كهذه عند إنشاء مهمة التحقق الجماعي بنجاح.

الرابط

{
  "status": "success",
  "task_id": "12345",
  "count_submitted": 3,
  "count_duplicates_removed": 0,
  "count_rejected_emails": 0,
  "count_processing": 3
}

طلب GET

تستخدم هذه النقطة لجلب نتائج مهمة التحقق الجماعي التي تم إنشاؤها مسبقًا. ستتضمن النتائج حالة المهمة بشكل عام، وإذا كانت المهمة قد اكتملت، فسيتم تضمين نتائج التحقق من البريد الإلكتروني.

رابط طلب GET

https://app.emailverify.io/api/v1/get-result-bulk-verification-task/?key=<Your_API_Key>&task_id=<Task_ID>

مثال على استجابة ناجحة

إليك مثال على الاستجابة بعد اكتمال مهمة التحقق:

طلب POST

{
  "count_checked": "1",
  "count_total": "1",
  "name": "Task Name",
  "progress_percentage": "100%",
  "task_id": "1234",
  "status": "verified",
  "results": {
    "email_batch": [
      {
        "address": "[email protected]",
        "status": "invalid",
        "sub_status": "No dns entries"
      }
    ]
  }
}

الفحوصات التي يتم تنفيذها في التحقق الجماعي

التحقق عبر Regex: التحقق من بنية عناوين البريد الإلكتروني باستخدام الأنماط القياسية لاكتشاف الأخطاء الإملائية وأخطاء التنسيق قبل المتابعة.

التحقق من سجلات MX: التحقق من وجود سجلات MX للتأكد من أن النطاق مهيأ لاستقبال الرسائل وأنه موجود ونشط.

التحقق عبر SMTP: إجراء تحقق مباشر عبر الاتصال بخادم SMTP الخاص بالمستلم للتأكد من أن البريد الإلكتروني نشط وقادر على استقبال الرسائل.

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

رسالة الخطأ

الوصف

مفتاح API غير صالح

إذا كان مفتاح API معطلاً أو غير موجود.

طلب غير صالح

إذا كان الطلب يحتوي على معلمات غير صحيحة.

لا توجد أرصدة متبقية

إذا لم يكن لدى المستخدم أي أرصدة متاحة.

يرجى المحاولة مرة أخرى

عندما يحدث خطأ من جانب النظام.

التحقق من اعتمادات الحساب

يرجى استخدام طلب GET التالي للتحقق من الاعتمادات الحالي (الأرصدة اليومية والفورية المتبقية).

رابط GET (HTTPS):

https://app.emailverify.io/api/v1/check-account-balance/?key=<Your_API_Key>

استبدل <Your_API_Key> بمفتاح API الفعّال الخاص بك.

الاستجابة (JSON):

{
  "api_status": "enabled",
  "daily_credits_limit": 150,
  "referral_credits": 100,
  "remaining_credits": 15000
}

إرشادات أداة البحث عن البريد الإلكتروني الفردي

مقدمة

تتيح لك واجهة برمجة التطبيقات (API) الخاصة بالبحث عن بريد إلكتروني واحد العثور على بريد إلكتروني مهني في الوقت الفعلي باستخدام اسم الشخص والنطاق الخاص بالشركة. تم تصميمها لتقديم نتائج سريعة ودقيقة وموثوقة، مما يجعلها مثالية لتوليد العملاء المحتملين وتحسين البيانات والتواصل.

يتيح لك هذا المسار استرجاع عناوين البريد الإلكتروني لكل طلب من خلال توفير تفاصيل مثل الاسم واسم النطاق. سيتم تقديم أول نتيجة يتم العثور عليها، وسيتم خصم عشرة أرصدة لكل طلب.

المصادقة

للوصول إلى واجهة برمجة التطبيقات، تحتاج إلى مفتاح API صالح. يمكنك إنشاء مفتاح API الشخصي الخاص بك من قسم واجهة البرمجة بعد تسجيل الدخول إلى حسابك. هذا المفتاح مطلوب للمصادقة ولإجراء الطلبات بشكل آمن.

مسار واجهة برمجة التطبيقات

الرابط

https://app.emailverify.io/api/v1/finder?key=YOUR_API_KEY&name=John&domain=example.com

مثال على الاستجابة عند العثور على البريد الإلكتروني

ستتلقى استجابة مطابقة في حال تم العثور على البريد الإلكتروني

استجابة عند العثور

{
  "email": "[email protected]",
  "status": "found"
}

مثال على الاستجابة عند عدم العثور على البريد الإلكتروني

ستتلقى استجابة مطابقة في حال لم يتم العثور على البريد الإلكتروني

استجابة عند عدم العثور

{
  "email": "null",
  "status": "not_found"
}

الفحوصات التي يتم تنفيذها في أداة البحث عن البريد الإلكتروني

فحص التركيبات: يتم فحص الاسم المقدم عبر خمسة وعشرين تركيبًا مختلفًا مع اسم النطاق وتحديد أي منها ينتج عنه عنوان بريد إلكتروني صالح.

فحص سجلات MX: التحقق من وجود سجلات تبادل البريد (MX) للتأكد من أن النطاق مهيأ لاستقبال الرسائل، مما يؤكد أنه موجود ونشط.

فحص قائمة الحظر لـ MX: تحديد النطاقات المدرجة في قوائم الحظر المعروفة الخاصة بالبريد العشوائي أو الأنشطة الضارة، مما يساعدك على تجنب الوجهات غير الموثوقة.

فحص SMTP: يتم التحقق في الوقت الفعلي من خلال إرسال طلب إلى خادم SMTP الخاص بالمستلم للتأكد من أن عنوان البريد الإلكتروني نشط ويمكنه استقبال الرسائل.

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

رسالة الخطأ

الوصف

مفتاح API غير صالح

إذا كان المفتاح معطلاً أو غير موجود

طلب غير صالح

معلمات غير صحيحة في مسار واجهة البرمجة

لا توجد أرصدة متبقية

لا يملك المستخدم أي أرصدة

النطاقات المجانية محظورة

عند محاولة العثور على بريد إلكتروني لنطاق مجاني

فحص اعتمادات الحساب

يرجى استخدام طلب GET التالي للتحقق من اعتمادات الحساب الحالي (الأرصدة اليومية والفورية المتبقية).

رابط طلب GET (HTTPS):

https://app.emailverify.io/api/v1/check-account-balance?key=<Your_API_Key>

هنا، استبدل <Your_API_Key> بمفتاح API النشط الخاص بك.

الاستجابة (JSON):

{
  "api_status": "enabled",
  "daily_credits_limit": 150,
  "referral_credits": 100
  "remaining_credits": 15000
}