Documentație pentru dezvoltatori

Referință API EvilMail

Integrați email temporar, domenii personalizate, citire inbox, management DNS și extragere inteligentă a codurilor de verificare în aplicațiile dumneavoastră.

URL de bază:https://evilmail.pro

Format:JSON

Autentificare:Cheie API / Sesiune

Protocoale:Doar HTTPS

Prezentare generală

API-ul EvilMail oferă acces programatic la toate funcționalitățile platformei. Creați emailuri temporare, gestionați domenii personalizate, citiți inbox-uri, extrageți coduri de verificare și controlați înregistrări DNS — totul printr-o interfață RESTful simplă.

API Email temporar

Creați inbox-uri temporare, citiți mesaje, expirare automată

API Domenii și email

Domenii personalizate, conturi de email, management DNS

Extragere Regex

Extragere automată a codurilor de verificare de la 8+ servicii

Format răspuns

Toate răspunsurile urmează o structură JSON consistentă:

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

Răspunsurile de eroare includ messageKey pentru mesaje de eroare localizate corespunzătoare limbii contului utilizatorului.

Autentificare

EvilMail folosește două metode de autentificare în funcție de tipul de endpoint. Toate cererile API trebuie făcute prin HTTPS.

Cheie API

Pentru crearea emailului temporar și extragerea codurilor de verificare. Necesită un abonament plătit activ.

X-API-Key: your_64char_hex_key

Cookie de sesiune

Pentru endpointurile de management al domeniilor, conturilor de email și DNS. Se setează după autentificare.

Cookie: evilmail_session=...

API-ul de email temporar necesită un plan plătit

API-ul de email temporar și endpointurile de extragere regex necesită un abonament activ Bronze, Gold sau Premium. Conturile gratuite pot folosi doar interfața web.

Email temporar

Plan plătit necesar

Creați adrese de email temporare cu TTL configurabil. Domenii disponibile: evilmail.pro, evilmail.cloud.

Create a temporary email address

Corp cerere

domainstringopționalDomain to use (default: evilmail.pro)

ttlMinutesnumberopționalLifetime: 10, 30, 60, 360, 1440 (default: 60)

Răspuns

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

Inbox și mesaje

Citiți emailurile primite din inbox-ul temporar. Mesajele sunt preluate prin IMAP și returnate în timp real.

Management domenii

Înregistrați domenii personalizate, verificați DNS și gestionați infrastructura de email. Limitele de domenii depind de planul dumneavoastră.

Conturi de email

Creați, listați și gestionați conturi de email sub domeniile verificate. Suportă creare individuală și în lot cu generare aleatorie a numelor de utilizator.

Extragere inteligentă a codurilor de verificare

Cheie API

Extrageți automat coduri de verificare din emailurile primite. Perfect pentru testare automată, fluxuri de înregistrare și pipeline-uri CI/CD.

Extract verification code from the latest email

Parametri

servicestringobligatoriuService name (see supported list)

emailstringobligatoriuEmail address to search (query param)

Răspuns

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

Servicii suportate

Serviciu	Endpoint	Tipar cod	Domenii expeditor
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

Aveți nevoie de un alt serviciu?

Dacă serviciul pe care îl căutați nu este listat mai sus, anunțați-ne. Extindem regulat integrările suportate pe baza feedback-ului dezvoltatorilor și putem adăuga noi tipare regex pentru orice serviciu de verificare bazat pe email.

Contactați-ne

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"

Management DNS

Management complet al înregistrărilor DNS prin PowerDNS. Suportă tipuri de înregistrări A, AAAA, CNAME, MX, TXT, NS, SRV și CAA. Înregistrările se propagă prin 4 nameservere distribuite geografic.

Exemple de cod

Exemple complete funcționale pentru crearea emailurilor temporare, citirea inbox-urilor și extragerea codurilor de verificare.

Flux email temporar

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

Extragere coduri de verificare

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"

Exemple management domenii

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

Limite de rată și planuri

Limite plan

Funcționalitate	Free	Bronze	Gold	Premium
Domenii personalizate	1	5	25	999
Emailuri / domeniu	5	999	999	999
API Email temporar	Doar web	Complet	Complet	Complet
Regex API	Doar web	Complet	Complet	Complet
Limită de rată API	100/hr	1,000/hr	5,000/hr	Nelimitat
Sesiuni temp / IP	10	10	10	10

Limite de rată pe endpoint

Per adresă 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}Bazat pe plan

Gestionarea erorilor

Toate răspunsurile de eroare includ un câmp status setat la "error", un mesaj lizibil și un messageKey opțional pentru mesaje de eroare localizate corespunzătoare limbii contului utilizatorului.

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

Cod	Stare	Descriere
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

Mesaje de eroare localizate

Folosiți câmpul messageKey pentru a afișa erori în limba preferată a utilizatorului. Suportat: engleză, turcă, rusă, ucraineană, poloneză, franceză, germană, azerbaidjană, persană, filipineză, hausa, akan.

API Explorer

Testați endpointurile API direct din browser. Introduceți cheia API și trimiteți cereri pentru a vedea răspunsuri în timp real.

API Explorerv1.0

evilmail.pro

POST

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

Cheie API

Corp cerere

domain

ttlMinutes

Trimiteți o cerere pentru a vedea răspunsul

Sunteți gata să integrați?

Obțineți cheia API din panoul de control și începeți să construiți. Acces complet cu orice plan plătit.

Începeți gratuit Vezi planurile

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

Serviciu

Endpoint

Tipar cod

Domenii expeditor

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

Funcționalitate

Free

Bronze

Gold

Premium

Domenii personalizate

999

Emailuri / domeniu

999

API Email temporar

Doar web

Complet

Regex API

Doar web

Complet

Limită de rată API

100/hr

1,000/hr

5,000/hr

Nelimitat

Sesiuni temp / IP

Cod

Stare

Descriere

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