API Sənədləri
EvilMail-i tətbiqlərinizə inteqrasiya edin
İcmal
EvilMail API platformanın bütün xüsusiyyətlərinə proqramatik giriş təmin edir.
Müvəqqəti E-poçt API
Birdəfəlik gələn qutuları yaradın, mesajları oxuyun, avtomatik müddət bitməsi
Domen və E-poçt API
Xüsusi domenlər, e-poçt hesabları, DNS idarəetməsi
Regex Çıxarma
8+ xidmətdən doğrulama kodlarının avtomatik çıxarılması
Official SDK Libraries
Cavab Formatı
Bütün cavablar ardıcıl JSON strukturuna uyğundur:
{
"status": "success" | "error",
"message": "Human-readable message (optional)",
"messageKey": "i18n key for localized errors (optional)",
"data": { ... }
}Xəta cavablarında lokallaşdırılmış xəta mesajları üçün messageKey var.
Autentifikasiya
Bütün API sorğuları X-API-Key başlığı vasitəsilə ötürülən API açarı tələb edir. Qeydiyyatdan sonra idarə panelindən API açarınızı əldə edin.
API Açarı
Müvəqqəti e-poçt yaratmaq və doğrulama kodlarını çıxarmaq üçün. Aktiv ödənişli abunəlik tələb olunur.
X-API-Key: your_64char_hex_keySessiya Kukisi
Domen, e-poçt hesabı və DNS idarəetmə son nöqtələri üçün. Girişdən sonra təyin edilir.
Cookie: evilmail_session=...Müvəqqəti E-poçt API ödənişli plan tələb edir
Müvəqqəti e-poçt API və regex çıxarma son nöqtələri aktiv abunəlik tələb edir.
Müvəqqəti E-poçt
Ödənişli Plan Tələb OlunurKonfiqurasiya edilə bilən TTL ilə birdəfəlik e-poçt ünvanları yaradın. Mövcud domenlər: evilmail.pro, evilmail.cloud.
Create a temporary email address
domainstringixtiyariDomain to use (default: evilmail.pro)ttlMinutesnumberixtiyariLifetime: 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.
Gələn Qutusu və Mesajlar
Müvəqqəti gələn qutunuzdan daxil olan e-poçtları oxuyun. Mesajlar IMAP vasitəsilə real vaxtda alınır.
Domen İdarəetməsi
Xüsusi domenlər qeydiyyatdan keçirin, DNS-i təsdiqləyin və e-poçt infrastrukturunuzu idarə edin.
E-poçt Hesabları
Təsdiqlənmiş domenləriniz altında e-poçt hesabları yaradın, siyahıya alın və idarə edin.
Ağıllı Doğrulama Kodu Çıxarma
API AçarıDaxil olan e-poçtlardan doğrulama kodlarının avtomatik çıxarılması. Avtomatik test və CI/CD üçün ideal.
Extract verification code from the latest email
servicestringtələb olunurService name (see supported list)emailstringtələb olunurEmail 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.
Dəstəklənən Xidmətlər
| Xidmət | Son nöqtə | Kod Nümunəsi | Göndərən Domenlər |
|---|---|---|---|
| /api/regex/google | G-XXXXXX | google.com, accounts.google.com | |
| /api/regex/facebook | XXXXXX | facebookmail.com, facebook.com | |
| Twitter/X | /api/regex/twitter | XXXXXXXX | twitter.com, x.com |
| /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"DNS İdarəetməsi
PowerDNS vasitəsilə tam DNS qeyd idarəetməsi. A, AAAA, CNAME, MX, TXT, NS, SRV və CAA qeyd növlərini dəstəkləyir.
Kod Nümunələri
Müvəqqəti e-poçt yaratmaq, gələn qutusu oxumaq və doğrulama kodlarını çıxarmaq üçün tam nümunələr.
Müvəqqəti E-poçt Axını
# 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": [...] } }Doğrulama Kodu Çıxarma
# 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"Domen İdarəetmə Nümunələri
# 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"}'Limitlər və Planlar
Plan Limitləri
| Xüsusiyyət | Free | Bronze | Gold | Premium |
|---|---|---|---|---|
| Xüsusi Domenlər | 1 | 5 | 25 | 999 |
| E-poçt / Domen | 5 | 999 | 999 | 999 |
| Müvəqqəti E-poçt API | Yalnız veb | Tam | Tam | Tam |
| Regex API | Yalnız veb | Tam | Tam | Tam |
| API Sürət Limiti | 100/hr | 1,000/hr | 5,000/hr | Limitsiz |
| Müvəqqəti Sessiyalar / IP | 10 | 10 | 10 | 10 |
Son Nöqtə Sürət Limitləri
Hər IP ünvan üçün
POST /api/auth/login10 / 15 minPOST /api/auth/register5 / 1 hourPOST /api/auth/forgot-password3 / 1 hourPOST /api/auth/reset-password5 / 15 minPUT /api/account/password5 / 15 minPOST /api/contact5 / 1 hourPOST /api/temp-email10 sessions / IPGET /api/regex/{service}Plana əsaslananXəta İdarəetməsi
Bütün xəta cavablarına status sahəsi, oxuna bilən mesaj və ixtiyari messageKey daxildir.
{
"status": "error",
"message": "Domain limit reached. Upgrade your plan for more.",
"messageKey": "domainLimitReached"
}| Kod | Status | Təsvir |
|---|---|---|
| 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 |
Lokallaşdırılmış Xəta Mesajları
İstifadəçinin üstünlük verdiyi dildə xətaları göstərmək üçün messageKey sahəsindən istifadə edin.
API Explorer
API nöqtələrini birbaşa brauzerinizdən sınayın. API açarınızı daxil edin və sorğular göndərin.
https://evilmail.pro/api/temp-emaildomainttlMinutesİnteqrasiyaya hazırsınız?
API açarınızı idarə panelindən alın və qurmağa başlayın.

