Fejlesztői dokumentáció

EvilMail API referencia

Integrálja az eldobható e-mailt, egyéni domaineket, beérkező üzenetek olvasását, DNS kezelést és az intelligens ellenőrzőkód-kinyerést alkalmazásaiba.

Alap URL:https://evilmail.pro

Formátum:JSON

Hitelesítés:API kulcs / Munkamenet

Protokollok:Csak HTTPS

Áttekintés

Az EvilMail API programozott hozzáférést biztosít az összes platform funkcióhoz. Hozzon létre eldobható e-maileket, kezeljen egyéni domaineket, olvasson beérkező üzeneteket, nyerjen ki ellenőrző kódokat és vezéreljen DNS rekordokat — mindezt egy egyszerű RESTful felületen keresztül.

Ideiglenes e-mail API

Eldobható postafiókok létrehozása, üzenetek olvasása, automatikus lejárat

Domain és e-mail API

Egyéni domainek, e-mail fiókok, DNS kezelés

Regex kinyerés

Automatikus ellenőrzőkód-kinyerés 8+ szolgáltatásból

Válasz formátum

Minden válasz egységes JSON struktúrát követ:

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

A hibaválaszok tartalmaznak messageKey-t a felhasználó fiókjának nyelvéhez illő lokalizált hibaüzenetekhez.

Hitelesítés

Az EvilMail két hitelesítési módszert használ a végpont típusától függően. Minden API kérést HTTPS-en keresztül kell végrehajtani.

API kulcs

Ideiglenes e-mail létrehozásához és ellenőrzőkód-kinyeréshez. Aktív fizetős előfizetés szükséges.

X-API-Key: your_64char_hex_key

Munkamenet cookie

Domain, e-mail fiók és DNS kezelési végpontokhoz. Bejelentkezés után állítódik be.

Cookie: evilmail_session=...

Az ideiglenes e-mail API fizetős csomagot igényel

Az ideiglenes e-mail API és a regex kinyerési végpontok aktív Bronze, Gold vagy Premium előfizetést igényelnek. Ingyenes fiókok csak a webes felületet használhatják.

Ideiglenes e-mail

Fizetős csomag szükséges

Ideiglenes e-mail címek létrehozása konfigurálható TTL-lel. Elérhető domainek: evilmail.pro, evilmail.cloud.

Create a temporary email address

Kéréstörzs

domainstringopcionálisDomain to use (default: evilmail.pro)

ttlMinutesnumberopcionálisLifetime: 10, 30, 60, 360, 1440 (default: 60)

Válasz

{
  "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.

Beérkező és üzenetek

Bejövő e-mailek olvasása az ideiglenes postafiókból. Az üzeneteket IMAP-on keresztül kérjük le és valós időben adjuk vissza.

Domain kezelés

Egyéni domainek regisztrálása, DNS ellenőrzés és e-mail infrastruktúra kezelése. A domain korlátok a csomagjától függenek.

E-mail fiókok

E-mail fiókok létrehozása, listázása és kezelése az ellenőrzött domainek alatt. Támogatja az egyéni és tömeges létrehozást véletlenszerű felhasználónév-generálással.

Intelligens ellenőrzőkód-kinyerés

API kulcs

Automatikusan kinyerheti az ellenőrző kódokat a bejövő e-mailekből. Tökéletes automatizált teszteléshez, regisztrációs folyamatokhoz és CI/CD csővezetékekhez.

Extract verification code from the latest email

Paraméterek

servicestringkötelezőService name (see supported list)

emailstringkötelezőEmail address to search (query param)

Válasz

{
  "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.

Támogatott szolgáltatások

Szolgáltatás	Végpont	Kódminta	Feladó domainek
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

Más szolgáltatásra van szüksége?

Ha a keresett szolgáltatás nincs fent felsorolva, tudassa velünk. Rendszeresen bővítjük a támogatott integrációkat a fejlesztői visszajelzések alapján, és bármely e-mail alapú ellenőrzési szolgáltatáshoz hozzáadhatunk új regex mintákat.

Kapcsolatfelvétel

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 kezelés

Teljes DNS rekord kezelés PowerDNS-en keresztül. Támogatja az A, AAAA, CNAME, MX, TXT, NS, SRV és CAA rekordtípusokat. A rekordok 4 földrajzilag elosztott névszerveren keresztül terjednek.

Kódpéldák

Teljes működő példák ideiglenes e-mailek létrehozásához, beérkező üzenetek olvasásához és ellenőrző kódok kinyeréséhez.

Ideiglenes e-mail folyamat

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": [...] } }

Ellenőrzőkód-kinyerés

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"

Domain kezelési példák

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"}'

Sebességkorlátok és csomagok

Csomag korlátok

Funkció	Free	Bronze	Gold	Premium
Egyéni domainek	1	5	25	999
E-mailek / domain	5	999	999	999
Ideiglenes e-mail API	Csak web	Teljes	Teljes	Teljes
Regex API	Csak web	Teljes	Teljes	Teljes
API sebességkorlát	100/hr	1,000/hr	5,000/hr	Korlátlan
Ideig. munkamenetek / IP	10	10	10	10

Végpont sebességkorlátok

IP címenként

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}Csomag alapú

Hibakezelés

Minden hibaválasz tartalmaz egy "error" értékre állított status mezőt, egy emberileg olvasható üzenetet és egy opcionális messageKey-t a felhasználó fiókjának nyelvéhez illő lokalizált hibaüzenetekhez.

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

Kód	Állapot	Leírás
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

Lokalizált hibaüzenetek

Használja a messageKey mezőt a hibák megjelenítéséhez a felhasználó preferált nyelvén. Támogatott: angol, török, orosz, ukrán, lengyel, francia, német, azerbajdzsán, perzsa, filippínó, hausza, akán.

API Explorer

Tesztelje az API végpontokat közvetlenül a böngészőből. Adja meg API kulcsát és küldjön kéréseket az élő válaszok megtekintéséhez.

API Explorerv1.0

evilmail.pro

POST

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

API kulcs

Kéréstörzs

domain

ttlMinutes

Küldjön kérést a válasz megtekintéséhez

Készen áll az integrációra?

Szerezze be API kulcsát a vezérlőpultról és kezdjen el fejleszteni. Teljes hozzáférés bármely fizetős csomaggal.

Ingyenes kezdés Csomagok megtekintése

{ "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" } }

Szolgáltatás

Végpont

Kódminta

Feladó domainek

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"}'

Funkció

Free

Bronze

Gold

Premium

Egyéni domainek

999

E-mailek / domain

999

Ideiglenes e-mail API

Csak web

Teljes

Regex API

Csak web

Teljes

API sebességkorlát

100/hr

1,000/hr

5,000/hr

Korlátlan

Ideig. munkamenetek / IP

Kód

Állapot

Leírás

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