Әзірлеуші құжаттамасы

EvilMail API анықтамасы

Уақытша пошта, жеке домендер, кіріс хаттарды оқу, DNS басқару және ақылды растау кодтарын алуды қосымшаларыңызға интеграциялаңыз.

Базалық URL:https://evilmail.pro

Формат:JSON

Аутентификация:API кілті / Сессия

Протоколдар:Тек HTTPS

Шолу

EvilMail API платформаның барлық мүмкіндіктеріне бағдарламалық қол жетімділік береді. Қарапайым RESTful интерфейс арқылы уақытша хаттар жасаңыз, жеке домендерді басқарыңыз, кіріс хаттарды оқыңыз, растау кодтарын алыңыз және DNS жазбаларын басқарыңыз.

Уақытша пошта 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 кілті

Уақытша пошта жасау және растау кодтарын алу үшін. Белсенді ақылы жазылым қажет.

X-API-Key: your_64char_hex_key

Сессия Cookie

Домен, пошта тіркелгісі және 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 кілті

Кіріс хаттардан растау кодтарын автоматты алыңыз. Автоматтандырылған тестілеу, тіркелгі тіркеу ағындары және 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 басқару

PowerDNS арқылы толық DNS жазба басқаруы. 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}Жоспарға негізделген

Қателерді өңдеу

Барлық қате жауаптарында "error" мәні бар 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 Explorer

API соңғы нүктелерін тікелей браузеріңізден тексеріңіз. API кілтіңізді енгізіңіз және тікелей жауаптарды көру үшін сұрау жіберіңіз.

API Explorerv1.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

Тек веб

Толық

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