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

پاسخ‌های خطا شامل messageKey برای پیام‌های خطای محلی هستند.

احراز هویت

تمام درخواست‌های API نیاز به کلید API دارند که از طریق هدر X-API-Key ارسال می‌شود. کلید API خود را پس از ثبت‌نام از پنل مدیریت دریافت کنید.

کلید API

برای ایجاد ایمیل موقت و استخراج کدهای تأیید. نیاز به اشتراک فعال پولی دارد.

X-API-Key: your_64char_hex_key

کوکی نشست

برای نقاط پایانی مدیریت دامنه، حساب ایمیل و DNS. پس از ورود تنظیم می‌شود.

Cookie: evilmail_session=...

API ایمیل موقت نیاز به طرح پولی دارد

API ایمیل موقت و نقاط پایانی استخراج regex نیاز به اشتراک فعال دارند.

ایمیل موقت

نیاز به طرح پولی

آدرس‌های ایمیل یکبار مصرف با 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

استخراج خودکار کدهای تأیید از ایمیل‌های دریافتی. مناسب برای تست خودکار و 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

به سرویس دیگری نیاز دارید؟

اگر سرویس مورد نظر شما در لیست نیست، به ما اطلاع دهید.

تماس با ما

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.

نمونه‌های کد

نمونه‌های کامل برای ایجاد ایمیل موقت، خواندن صندوق ورودی و استخراج کدهای تأیید.

جریان ایمیل موقت

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 ایمیل موقت	فقط وب	کامل	کامل	کامل
API Regex	فقط وب	کامل	کامل	کامل
محدودیت نرخ 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، پیام قابل خواندن و 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

بدنه درخواست

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 ایمیل موقت

فقط وب

کامل

API Regex

فقط وب

کامل

محدودیت نرخ 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