توثيق المطورين

مرجع API EvilMail

ادمج البريد المؤقت والنطاقات المخصصة وقراءة صندوق الوارد وإدارة DNS واستخراج رموز التحقق الذكي في تطبيقاتك.

عنوان URL الأساسي:https://evilmail.pro

الصيغة:JSON

المصادقة:API Key / جلسة

البروتوكولات:HTTPS فقط

نظرة عامة

توفر API EvilMail وصولاً برمجياً لجميع ميزات المنصة. أنشئ بريداً مؤقتاً، وأدر النطاقات المخصصة، واقرأ صندوق الوارد، واستخرج رموز التحقق، وتحكم بسجلات DNS — عبر واجهة RESTful بسيطة.

API البريد المؤقت

إنشاء صناديق وارد مؤقتة، قراءة الرسائل، انتهاء تلقائي

API النطاقات والبريد

النطاقات المخصصة، حسابات البريد، إدارة DNS

استخراج Regex

استخراج تلقائي لرموز التحقق من أكثر من 8 خدمات

صيغة الاستجابة

جميع الاستجابات تتبع بنية JSON متسقة:

{
  "status": "success" | "error",
  "message": "Human-readable message (optional)",
  "messageKey": "i18n key for localized errors (optional)",
  "data": { ... }
}

تتضمن استجابات الخطأ messageKey لرسائل خطأ مترجمة تتوافق مع لغة حساب المستخدم.

المصادقة

يستخدم EvilMail طريقتين للمصادقة حسب نوع نقطة النهاية. يجب إجراء جميع طلبات API عبر HTTPS.

API Key

لإنشاء البريد المؤقت واستخراج رموز التحقق. يتطلب اشتراكاً مدفوعاً نشطاً.

X-API-Key: your_64char_hex_key

ملف تعريف ارتباط الجلسة

لنقاط نهاية إدارة النطاقات وحسابات البريد وDNS. يُعيَّن بعد تسجيل الدخول.

Cookie: evilmail_session=...

API البريد المؤقت يتطلب خطة مدفوعة

تتطلب نقاط نهاية API البريد المؤقت واستخراج Regex اشتراك Bronze أو Gold أو Premium نشطاً. الحسابات المجانية يمكنها استخدام واجهة الويب فقط.

البريد المؤقت

خطة مدفوعة مطلوبة

إنشاء عناوين بريد مؤقتة مع TTL قابل للتكوين. النطاقات المتاحة: evilmail.pro, evilmail.cloud.

Create a temporary email address

جسم الطلب

domainstringاختياريDomain to use (default: evilmail.pro)

ttlMinutesnumberاختياريLifetime: 10, 30, 60, 360, 1440 (default: 60)

الاستجابة

{
  "status": "success",
  "data": {
    "email": "[email protected]",
    "domain": "evilmail.pro",
    "sessionToken": "a1b2c3d4...",
    "ttlMinutes": 60,
    "expiresAt": "2026-03-07T15:30:00.000Z"
  }
}

Available domains: evilmail.pro, evilmail.cloud. Requires an active paid subscription.

صندوق الوارد والرسائل

اقرأ الرسائل الواردة من صندوق الوارد المؤقت. يتم جلب الرسائل عبر IMAP وإعادتها في الوقت الحقيقي.

إدارة النطاقات

سجّل النطاقات المخصصة، وتحقق من DNS، وأدر البنية التحتية للبريد. تعتمد حدود النطاقات على خطتك.

حسابات البريد

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

استخراج ذكي لرموز التحقق

API Key

استخراج رموز التحقق تلقائياً من الرسائل الواردة. مثالي للاختبار الآلي وتدفقات تسجيل الحسابات وخطوط أنابيب CI/CD.

Extract verification code from the latest email

المعاملات

servicestringمطلوبService name (see supported list)

emailstringمطلوبEmail address to search (query param)

الاستجابة

{
  "status": "success",
  "data": {
    "code": "847291",
    "service": "google",
    "email": "[email protected]",
    "from": "[email protected]",
    "subject": "Your verification code",
    "date": "2026-03-07T14:22:00.000Z"
  }
}

Searches the last 20 messages. You must own the domain.

الخدمات المدعومة

الخدمة	نقطة النهاية	نمط الرمز	نطاقات المرسل
Google	/api/regex/google	G-XXXXXX	google.com, accounts.google.com
Facebook	/api/regex/facebook	XXXXXX	facebookmail.com, facebook.com
Twitter/X	/api/regex/twitter	XXXXXXXX	twitter.com, x.com
Instagram	/api/regex/instagram	XXXXXX	instagram.com, mail.instagram.com
TikTok	/api/regex/tiktok	XXXX-XXXXXX	tiktok.com
Discord	/api/regex/discord	XXXXXX	discord.com
LinkedIn	/api/regex/linkedin	XXXXXX	linkedin.com
iCloud	/api/regex/icloud	XXXXXX	apple.com, id.apple.com

تحتاج خدمة مختلفة؟

إذا لم تجد الخدمة التي تبحث عنها في القائمة أعلاه، أخبرنا. نوسّع تكاملاتنا المدعومة بانتظام بناءً على ملاحظات المطورين ويمكننا إضافة أنماط regex جديدة لأي خدمة تحقق عبر البريد الإلكتروني.

تواصل معنا

api-example

# Extract Google verification code
curl "https://evilmail.pro/api/regex/[email protected]" \
  -H "X-API-Key: YOUR_API_KEY"

# Extract Discord verification code
curl "https://evilmail.pro/api/regex/[email protected]" \
  -H "X-API-Key: YOUR_API_KEY"

# Extract TikTok code
curl "https://evilmail.pro/api/regex/[email protected]" \
  -H "X-API-Key: YOUR_API_KEY"

إدارة DNS

إدارة كاملة لسجلات DNS عبر PowerDNS. يدعم أنواع سجلات A وAAAA وCNAME وMX وTXT وNS وSRV وCAA. تنتشر السجلات عبر 4 خوادم أسماء موزعة جغرافياً.

أمثلة الكود

أمثلة عمل كاملة لإنشاء بريد مؤقت وقراءة صندوق الوارد واستخراج رموز التحقق.

تدفق البريد المؤقت

api-example

# Create a temporary email
curl -X POST https://evilmail.pro/api/temp-email \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"domain": "evilmail.pro", "ttlMinutes": 60}'

# Response: { "data": { "email": "...", "sessionToken": "abc123..." } }

# Poll for incoming messages using the session token
curl https://evilmail.pro/api/temp-email/abc123...

# Response includes messages array
# { "data": { "email": "...", "messages": [...] } }

استخراج رمز التحقق

api-example

# Extract Google verification code
curl "https://evilmail.pro/api/regex/[email protected]" \
  -H "X-API-Key: YOUR_API_KEY"

# Extract Discord verification code
curl "https://evilmail.pro/api/regex/[email protected]" \
  -H "X-API-Key: YOUR_API_KEY"

# Extract TikTok code
curl "https://evilmail.pro/api/regex/[email protected]" \
  -H "X-API-Key: YOUR_API_KEY"

أمثلة إدارة النطاقات

api-example

# Add a domain
curl -X POST https://evilmail.pro/api/domains \
  -H "Content-Type: application/json" \
  -H "Cookie: evilmail_session=YOUR_SESSION" \
  -d '{"domain": "mydomain.com"}'

# List domains
curl https://evilmail.pro/api/domains \
  -H "Cookie: evilmail_session=YOUR_SESSION"

# Verify DNS
curl -X POST https://evilmail.pro/api/domains/check \
  -H "Content-Type: application/json" \
  -H "Cookie: evilmail_session=YOUR_SESSION" \
  -d '{"domain": "mydomain.com"}'

# Create email account
curl -X POST https://evilmail.pro/api/accounts \
  -H "Content-Type: application/json" \
  -H "Cookie: evilmail_session=YOUR_SESSION" \
  -d '{"email": "[email protected]", "password": "secure123"}'

حدود المعدل والخطط

حدود الخطة

الميزة	Free	Bronze	Gold	Premium
نطاقات مخصصة	1	5	25	999
بريد / نطاق	5	999	999	999
API البريد المؤقت	ويب فقط	كامل	كامل	كامل
Regex API	ويب فقط	كامل	كامل	كامل
حد معدل API	100/hr	1,000/hr	5,000/hr	غير محدود
جلسات مؤقتة / IP	10	10	10	10

حدود معدل نقاط النهاية

لكل عنوان IP

POST /api/auth/login10 / 15 min

POST /api/auth/register5 / 1 hour

POST /api/auth/forgot-password3 / 1 hour

POST /api/auth/reset-password5 / 15 min

PUT /api/account/password5 / 15 min

POST /api/contact5 / 1 hour

POST /api/temp-email10 sessions / IP

GET /api/regex/{service}حسب الخطة

معالجة الأخطاء

تتضمن جميع استجابات الخطأ حقل status بقيمة "error"، ورسالة قابلة للقراءة، وmessageKey اختياري لرسائل خطأ مترجمة تتوافق مع لغة حساب المستخدم.

{
  "status": "error",
  "message": "Domain limit reached. Upgrade your plan for more.",
  "messageKey": "domainLimitReached"
}

الكود	الحالة	الوصف
200	Success	Request completed successfully
400	Bad Request	Missing or invalid parameters
401	Unauthorized	Invalid or missing authentication
403	Forbidden	Insufficient permissions or plan limits
404	Not Found	Resource does not exist
409	Conflict	Resource already exists (duplicate)
429	Rate Limited	Too many requests, slow down
500	Server Error	Internal server error

رسائل خطأ مترجمة

استخدم حقل messageKey لعرض الأخطاء بلغة المستخدم المفضلة. مدعوم: الإنجليزية، التركية، الروسية، الأوكرانية، البولندية، الفرنسية، الألمانية، الأذربيجانية، الفارسية، الفلبينية، الهوسا، الأكان.

مستكشف API

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

مستكشف APIv1.0

evilmail.pro

POST

POSThttps://evilmail.pro/api/temp-email

API Key

جسم الطلب

domain

ttlMinutes

أرسل طلباً لرؤية الاستجابة

مستعد للدمج؟

احصل على مفتاح API من لوحة التحكم وابدأ البناء. وصول كامل مع أي خطة مدفوعة.

ابدأ مجاناً عرض الخطط

{ "status": "success", "data": { "email": "[email protected]", "domain": "evilmail.pro", "sessionToken": "a1b2c3d4...", "ttlMinutes": 60, "expiresAt": "2026-03-07T15:30:00.000Z" } }

{ "status": "success", "data": { "code": "847291", "service": "google", "email": "[email protected]", "from": "[email protected]", "subject": "Your verification code", "date": "2026-03-07T14:22:00.000Z" } }

الخدمة

نقطة النهاية

نمط الرمز

نطاقات المرسل

Google

/api/regex/google

G-XXXXXX

google.com, accounts.google.com

Facebook

/api/regex/facebook

XXXXXX

facebookmail.com, facebook.com

Twitter/X

/api/regex/twitter

XXXXXXXX

twitter.com, x.com

Instagram

/api/regex/instagram

XXXXXX

instagram.com, mail.instagram.com

TikTok

/api/regex/tiktok

XXXX-XXXXXX

tiktok.com

Discord

/api/regex/discord

XXXXXX

discord.com

/api/regex/linkedin

XXXXXX

linkedin.com

iCloud

/api/regex/icloud

XXXXXX

apple.com, id.apple.com

# Extract Google verification code curl "https://evilmail.pro/api/regex/[email protected]" \ -H "X-API-Key: YOUR_API_KEY" # Extract Discord verification code curl "https://evilmail.pro/api/regex/[email protected]" \ -H "X-API-Key: YOUR_API_KEY" # Extract TikTok code curl "https://evilmail.pro/api/regex/[email protected]" \ -H "X-API-Key: YOUR_API_KEY"

# Create a temporary email curl -X POST https://evilmail.pro/api/temp-email \ -H "Content-Type: application/json" \ -H "X-API-Key: YOUR_API_KEY" \ -d '{"domain": "evilmail.pro", "ttlMinutes": 60}' # Response: { "data": { "email": "...", "sessionToken": "abc123..." } } # Poll for incoming messages using the session token curl https://evilmail.pro/api/temp-email/abc123... # Response includes messages array # { "data": { "email": "...", "messages": [...] } }

# Add a domain curl -X POST https://evilmail.pro/api/domains \ -H "Content-Type: application/json" \ -H "Cookie: evilmail_session=YOUR_SESSION" \ -d '{"domain": "mydomain.com"}' # List domains curl https://evilmail.pro/api/domains \ -H "Cookie: evilmail_session=YOUR_SESSION" # Verify DNS curl -X POST https://evilmail.pro/api/domains/check \ -H "Content-Type: application/json" \ -H "Cookie: evilmail_session=YOUR_SESSION" \ -d '{"domain": "mydomain.com"}' # Create email account curl -X POST https://evilmail.pro/api/accounts \ -H "Content-Type: application/json" \ -H "Cookie: evilmail_session=YOUR_SESSION" \ -d '{"email": "[email protected]", "password": "secure123"}'

الميزة

Free

Bronze

Gold

Premium

نطاقات مخصصة

999

بريد / نطاق

999

API البريد المؤقت

ويب فقط

كامل

Regex API

ويب فقط

كامل

حد معدل API

100/hr

1,000/hr

5,000/hr

غير محدود

جلسات مؤقتة / IP

الكود

الحالة

الوصف

200

Success

Request completed successfully

400

Bad Request

Missing or invalid parameters

401

Unauthorized

Invalid or missing authentication

403

Forbidden

Insufficient permissions or plan limits

404

Not Found

Resource does not exist

409

Conflict

Resource already exists (duplicate)

429

Rate Limited

Too many requests, slow down

500

Server Error

Internal server error