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

المصادقة

أرسل مفتاح API بوصفه رمز bearer في ترويسة Authorization مع كل طلب. احتفظ بالمفاتيح على خادمك. لا تضعها أبدًا في كود المتصفح أو تطبيقات الجوال.

Authorization: Bearer YOUR_API_KEY

عنوان URL الأساسي لكل نقطة نهاية هو https://bouncebell.com/api/v1.

تحقق من عنوان واحد

GET https://bouncebell.com/api/v1/verify

مثال

curl "https://bouncebell.com/api/v1/verify?email=rini.elizabeth%40acme-foods.example" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "email": "rini.elizabeth@acme-foods.example",
  "status": "valid",
  "reason": "mailbox_exists",
  "domain": "acme-foods.example",
  "mx_record": "mx1.acme-foods.example",
  "disposable": false,
  "role": false,
  "free_provider": false,
  "catch_all": false,
  "did_you_mean": null,
  "checked_at": "2026-10-30T09:30:12Z",
  "credits_used": 1
}

حقول النتيجة

الحالات

الدفعات

أرسل ما يصل إلى ١٠٠٬٠٠٠ عنوان في طلب واحد. تعمل الدفعة في الخلفية؛ استعلم عن حالتها أو قدّم callback_url وسنستدعيه عند اكتمال الدفعة.

إنشاء دفعة

POST https://bouncebell.com/api/v1/batches

curl -X POST "https://bouncebell.com/api/v1/batches" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "October import", "emails": ["a@example.com", "b@example.com"],
       "callback_url": "https://yourapp.example/hooks/bouncebell"}'

{ "id": "bat_8f2k1q3m9x7w4p", "status": "queued", "total": 2, "done": 0 }

يُحجز الرصيد لكل عنوان فريد عند إنشاء الدفعة، ويُسترد رصيد النتائج غير المعروفة عند انتهائها. يتلقى الاستدعاء طلب POST يحتوي على {"event": "batch.completed", "batch_id": "...", "status": "done", "counts": {...}}. يجب أن تستخدم روابط الاستدعاء HTTPS.

التحقق من التقدم

GET https://bouncebell.com/api/v1/batches/{id}

{ "id": "bat_8f2k1q3m9x7w4p", "status": "running", "total": 2, "done": 1 }

تكون الحالة queued أو running أو done. وعندما تكون done، تتضمن الاستجابة أيضًا counts حسب الحالة.

تنزيل النتائج

GET https://bouncebell.com/api/v1/batches/{id}/results

يُرجع JSON افتراضيًا. أضف ?format=csv للحصول على ملف CSV. يحتوي كل صف على الحقول نفسها الموجودة في الفحص الفردي.

الرصيد

GET https://bouncebell.com/api/v1/credits

{ "credits_remaining": 33420 }

الأخطاء والحدود

تُرجع الأخطاء نص JSON يحتوي على رمز error وmessage مقروءة.

الفحوص الفردية محدودة بـ ٢٠ طلبًا في الثانية لكل مفتاح. اطلب منا إذا احتجت إلى المزيد.