Utvecklardokumentation

EvilMail API-referens

Integrera engångs-e-post, anpassade domäner, inkorgsläsning, DNS-hantering och smart extraktion av verifieringskoder i dina applikationer.

Bas-URL:https://evilmail.pro

Format:JSON

Autentisering:API-nyckel / Session

Protokoll:Endast HTTPS

Översikt

EvilMail API ger programmatisk åtkomst till alla plattformsfunktioner. Skapa engångs-e-post, hantera anpassade domäner, läs inkorgar, extrahera verifieringskoder och kontrollera DNS-poster — allt genom ett enkelt RESTful-gränssnitt.

Tillfällig e-post-API

Skapa engångsinkorgar, läs meddelanden, automatisk utgång

Domän- och e-post-API

Anpassade domäner, e-postkonton, DNS-hantering

Regex-extraktion

Automatisk extraktion av verifieringskoder från 8+ tjänster

Svarsformat

Alla svar följer en konsekvent JSON-struktur:

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

Felsvar inkluderar messageKey för lokaliserade felmeddelanden som matchar användarens kontospråk.

Autentisering

EvilMail använder två autentiseringsmetoder beroende på endpointtyp. Alla API-förfrågningar måste göras via HTTPS.

API-nyckel

För skapande av tillfällig e-post och extraktion av verifieringskoder. Kräver en aktiv betald prenumeration.

X-API-Key: your_64char_hex_key

Sessionscookie

För endpoints för domän-, e-postkonto- och DNS-hantering. Ställs in efter inloggning.

Cookie: evilmail_session=...

Tillfällig e-post-API kräver en betald plan

Tillfällig e-post-API och regex-extraktionsendpoints kräver en aktiv Bronze-, Gold- eller Premium-prenumeration. Gratiskonton kan bara använda webbgränssnittet.

Tillfällig e-post

Betald plan krävs

Skapa tillfälliga e-postadresser med konfigurerbar TTL. Tillgängliga domäner: evilmail.pro, evilmail.cloud.

Create a temporary email address

Förfrågningskropp

domainstringvalfriDomain to use (default: evilmail.pro)

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

Svar

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

Inkorg och meddelanden

Läs inkommande e-post från din tillfälliga inkorg. Meddelanden hämtas via IMAP och returneras i realtid.

Domänhantering

Registrera anpassade domäner, verifiera DNS och hantera din e-postinfrastruktur. Domängränser beror på din plan.

E-postkonton

Skapa, lista och hantera e-postkonton under dina verifierade domäner. Stöder enskilt och batchskapande med slumpmässig användarnamnsgenerering.

Smart extraktion av verifieringskoder

API-nyckel

Extrahera automatiskt verifieringskoder från inkommande e-post. Perfekt för automatiserad testning, registreringsflöden och CI/CD-pipelines.

Extract verification code from the latest email

Parametrar

servicestringobligatoriskService name (see supported list)

emailstringobligatoriskEmail address to search (query param)

Svar

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

Stödda tjänster

Tjänst	Endpoint	Kodmönster	Avsändardomäner
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

Behöver du en annan tjänst?

Om tjänsten du letar efter inte finns listad ovan, meddela oss. Vi utökar regelbundet våra integrationer baserat på utvecklarfeedback och kan lägga till nya regexmönster för alla e-postbaserade verifieringstjänster.

Kontakta oss

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-hantering

Fullständig DNS-posthantering via PowerDNS. Stöder A-, AAAA-, CNAME-, MX-, TXT-, NS-, SRV- och CAA-posttyper. Poster propageras via 4 geografiskt distribuerade namnservrar.

Kodexempel

Kompletta fungerande exempel för att skapa tillfälliga e-postadresser, läsa inkorgar och extrahera verifieringskoder.

Tillfälligt e-postflöde

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

Extraktion av verifieringskoder

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"

Exempel på domänhantering

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

Hastighetsgränser och planer

Plangränser

Funktion	Free	Bronze	Gold	Premium
Anpassade domäner	1	5	25	999
E-post / domän	5	999	999	999
Tillfällig e-post-API	Endast webb	Fullständig	Fullständig	Fullständig
Regex API	Endast webb	Fullständig	Fullständig	Fullständig
API-hastighetsgräns	100/hr	1,000/hr	5,000/hr	Obegränsat
Tillfälliga sessioner / IP	10	10	10	10

Endpoint-hastighetsgränser

Per IP-adress

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}Planbaserad

Felhantering

Alla felsvar inkluderar ett statusfält satt till "error", ett läsbart meddelande och en valfri messageKey för lokaliserade felmeddelanden som matchar användarens kontospråk.

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

Kod	Status	Beskrivning
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

Lokaliserade felmeddelanden

Använd messageKey-fältet för att visa fel på användarens föredragna språk. Stöds: engelska, turkiska, ryska, ukrainska, polska, franska, tyska, azerbajdzjanska, persiska, filippinska, hausa, akan.

API Explorer

Testa API-endpoints direkt i din webbläsare. Ange din API-nyckel och skicka förfrågningar för att se livesvar.

API Explorerv1.0

evilmail.pro

POST

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

API-nyckel

Förfrågningskropp

domain

ttlMinutes

Skicka en förfrågan för att se svaret

Redo att integrera?

Hämta din API-nyckel från kontrollpanelen och börja bygga. Full åtkomst med alla betalplaner.

Kom igång gratis Visa planer

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

Tjänst

Endpoint

Kodmönster

Avsändardomäner

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

Funktion

Free

Bronze

Gold

Premium

Anpassade domäner

999

E-post / domän

999

Tillfällig e-post-API

Endast webb

Fullständig

Regex API

Endast webb

Fullständig

API-hastighetsgräns

100/hr

1,000/hr

5,000/hr

Obegränsat

Tillfälliga sessioner / IP

Kod

Status

Beskrivning

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