Documentazione per sviluppatori

Riferimento API EvilMail

Integra email usa e getta, domini personalizzati, lettura caselle, gestione DNS ed estrazione intelligente codici di verifica nelle tue applicazioni.

URL base:https://evilmail.pro

Formato:JSON

Autenticazione:Chiave API / Sessione

Protocolli:Solo HTTPS

Panoramica

L'API EvilMail fornisce accesso programmatico a tutte le funzionalità della piattaforma. Crea email usa e getta, gestisci domini personalizzati, leggi caselle di posta, estrai codici di verifica e controlla record DNS, tutto attraverso un'interfaccia RESTful semplice.

API email temporanee

Crea caselle usa e getta, leggi messaggi, scadenza automatica

API domini ed email

Domini personalizzati, account email, gestione DNS

Estrazione Regex

Estrazione automatica codici di verifica da oltre 8 servizi

Formato risposta

Tutte le risposte seguono una struttura JSON coerente:

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

Le risposte di errore includono messageKey per messaggi di errore localizzati nella lingua dell'account utente.

Autenticazione

EvilMail utilizza due metodi di autenticazione a seconda del tipo di endpoint. Tutte le richieste API devono essere effettuate tramite HTTPS.

Chiave API

Per la creazione di email temporanee e l'estrazione di codici di verifica. Richiede un abbonamento a pagamento attivo.

X-API-Key: your_64char_hex_key

Cookie di sessione

Per gli endpoint di gestione domini, account email e DNS. Impostato dopo il login.

Cookie: evilmail_session=...

L'API email temporanee richiede un piano a pagamento

Gli endpoint API per email temporanee e estrazione regex richiedono un abbonamento Bronze, Gold o Premium attivo. Gli account gratuiti possono utilizzare solo l'interfaccia web.

Email temporanea

Piano a pagamento richiesto

Crea indirizzi email usa e getta con TTL configurabile. Domini disponibili: evilmail.pro, evilmail.cloud.

Create a temporary email address

Corpo della richiesta

domainstringfacoltativoDomain to use (default: evilmail.pro)

ttlMinutesnumberfacoltativoLifetime: 10, 30, 60, 360, 1440 (default: 60)

Risposta

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

Casella e messaggi

Leggi le email in arrivo dalla tua casella temporanea. I messaggi vengono recuperati tramite IMAP e restituiti in tempo reale.

Gestione domini

Registra domini personalizzati, verifica il DNS e gestisci la tua infrastruttura email. I limiti di dominio dipendono dal tuo piano.

Account email

Crea, elenca e gestisci account email sotto i tuoi domini verificati. Supporta la creazione singola e in blocco con generazione casuale di nomi utente.

Estrazione intelligente codici di verifica

Chiave API

Estrai automaticamente codici di verifica dalle email in arrivo. Perfetto per test automatizzati, flussi di registrazione account e pipeline CI/CD.

Extract verification code from the latest email

Parametri

servicestringobbligatorioService name (see supported list)

emailstringobbligatorioEmail address to search (query param)

Risposta

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

Servizi supportati

Servizio	Endpoint	Pattern codice	Domini mittente
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

Hai bisogno di un servizio diverso?

Se il servizio che cerchi non è elencato sopra, faccelo sapere. Espandiamo regolarmente le integrazioni supportate in base al feedback degli sviluppatori e possiamo aggiungere nuovi pattern regex per qualsiasi servizio di verifica basato su email.

Contattaci

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"

Gestione DNS

Gestione completa dei record DNS tramite PowerDNS. Supporta tipi di record A, AAAA, CNAME, MX, TXT, NS, SRV e CAA. I record vengono propagati tramite 4 nameserver distribuiti geograficamente.

Esempi di codice

Esempi completi e funzionanti per creare email temporanee, leggere caselle ed estrarre codici di verifica.

Flusso email temporanea

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

Estrazione codice di verifica

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"

Esempi gestione domini

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

Limiti di frequenza e piani

Limiti del piano

Funzionalità	Free	Bronze	Gold	Premium
Domini personalizzati	1	5	25	999
Email / Dominio	5	999	999	999
API email temporanee	Solo web	Completo	Completo	Completo
Regex API	Solo web	Completo	Completo	Completo
Limite frequenza API	100/hr	1,000/hr	5,000/hr	Illimitato
Sessioni temp / IP	10	10	10	10

Limiti di frequenza endpoint

Per indirizzo 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}In base al piano

Gestione errori

Tutte le risposte di errore includono un campo status impostato su "error", un messaggio leggibile e un messageKey opzionale per messaggi di errore localizzati nella lingua dell'account utente.

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

Codice	Stato	Descrizione
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

Messaggi di errore localizzati

Usa il campo messageKey per visualizzare errori nella lingua preferita dell'utente. Supportate: inglese, turco, russo, ucraino, polacco, francese, tedesco, azerbaigiano, persiano, filippino, hausa, akan.

API Explorer

Testa gli endpoint API direttamente dal tuo browser. Inserisci la tua chiave API e invia richieste per vedere le risposte in tempo reale.

API Explorerv1.0

evilmail.pro

POST

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

Chiave API

Corpo della richiesta

domain

ttlMinutes

Invia una richiesta per vedere la risposta

Pronto per l'integrazione?

Ottieni la tua chiave API dal pannello di controllo e inizia a costruire. Accesso completo con qualsiasi piano a pagamento.

Inizia gratis Vedi i piani

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

Servizio

Endpoint

Pattern codice

Domini mittente

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

Funzionalità

Free

Bronze

Gold

Premium

Domini personalizzati

999

Email / Dominio

999

API email temporanee

Solo web

Completo

Regex API

Solo web

Completo

Limite frequenza API

100/hr

1,000/hr

5,000/hr

Illimitato

Sessioni temp / IP

Codice

Stato

Descrizione

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