نظرة عامة على واجهة برمجة التطبيقات
توفر واجهة REST API الخاصة بـ EvilMail وصولاً برمجياً كاملاً إلى جميع ميزات الخدمة. يمكنك إنشاء صناديق بريد مؤقتة وقراءة الرسائل وحذفها وإدارة النطاقات المخصصة، كل ذلك من خلال طلبات HTTP بسيطة.
المصادقة
تتطلب جميع طلبات API مفتاح وصول صالح. يمكنك الحصول على مفتاحك من لوحة تحكم EvilMail. أرسل المفتاح في ترويسة كل طلب:
curl -H "Authorization: Bearer YOUR_API_KEY"
https://api.evilmail.com/v1/inboxesإنشاء صندوق بريد مؤقت
لإنشاء صندوق بريد جديد، أرسل طلب POST:
curl -X POST https://api.evilmail.com/v1/inboxes
-H "Authorization: Bearer YOUR_API_KEY"
-H "Content-Type: application/json"
-d '{"domain": "yourdomain.com", "prefix": "test"}'الاستجابة تتضمن عنوان البريد الإلكتروني المُنشأ ومعرّف صندوق البريد الذي ستستخدمه في الطلبات اللاحقة.
قراءة الرسائل
لاسترجاع الرسائل الواردة لصندوق بريد معين:
curl https://api.evilmail.com/v1/inboxes/{inbox_id}/messages
-H "Authorization: Bearer YOUR_API_KEY"تُرجع الاستجابة قائمة بالرسائل تتضمن المُرسل والموضوع والمحتوى النصي ومحتوى HTML والمرفقات.
Webhooks للإشعارات الفورية
بدلاً من الاستعلام المتكرر عن الرسائل الجديدة، يمكنك تسجيل عنوان Webhook ليتم إخطارك فوراً عند وصول رسالة جديدة:
curl -X POST https://api.evilmail.com/v1/webhooks
-H "Authorization: Bearer YOUR_API_KEY"
-H "Content-Type: application/json"
-d '{"inbox_id": "abc123", "url": "https://yourapp.com/webhook/email"}'حدود الاستخدام ومعالجة الأخطاء
تخضع الواجهة لحدود استخدام تعتمد على خطة اشتراكك. تُرجع الاستجابات ترويسات X-RateLimit-Remaining و X-RateLimit-Reset لمساعدتك في إدارة الطلبات. في حالة تجاوز الحد، ستتلقى استجابة بالرمز 429 Too Many Requests. تأكد من تنفيذ منطق إعادة المحاولة مع تأخير تصاعدي في تطبيقك.