Dokumentace pro vývojáře

Reference API EvilMail

Integrujte jednorázový email, vlastní domény, čtení doručené pošty, správu DNS a inteligentní extrakci ověřovacích kódů do svých aplikací.

Základní URL:https://evilmail.pro

Formát:JSON

Autentizace:API klíč / Relace

Protokoly:Pouze HTTPS

Přehled

API EvilMail poskytuje programový přístup ke všem funkcím platformy. Vytvářejte jednorázové emaily, spravujte vlastní domény, čtěte doručenou poštu, extrahujte ověřovací kódy a kontrolujte DNS záznamy — vše prostřednictvím jednoduchého RESTful rozhraní.

API pro dočasné emaily

Vytvářejte jednorázové schránky, čtěte zprávy, automatická expirace

API pro domény a emaily

Vlastní domény, emailové účty, správa DNS

Extrakce Regex

Automatická extrakce ověřovacích kódů z 8+ služeb

Formát odpovědi

Všechny odpovědi mají konzistentní JSON strukturu:

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

Chybové odpovědi obsahují messageKey pro lokalizované chybové zprávy odpovídající jazyku uživatelského účtu.

Autentizace

EvilMail používá dvě metody autentizace v závislosti na typu endpointu. Všechny API požadavky musí být provedeny přes HTTPS.

API klíč

Pro vytváření dočasných emailů a extrakci ověřovacích kódů. Vyžaduje aktivní placené předplatné.

X-API-Key: your_64char_hex_key

Session cookie

Pro endpointy správy domén, emailových účtů a DNS. Nastaven po přihlášení.

Cookie: evilmail_session=...

API pro dočasné emaily vyžaduje placený plán

API pro dočasné emaily a endpointy extrakce regex vyžadují aktivní předplatné Bronze, Gold nebo Premium. Bezplatné účty mohou používat pouze webové rozhraní.

Dočasný email

Vyžadován placený plán

Vytvářejte jednorázové emailové adresy s konfigurovatelným TTL. Dostupné domény: evilmail.pro, evilmail.cloud.

Create a temporary email address

Tělo požadavku

domainstringvolitelnéDomain to use (default: evilmail.pro)

ttlMinutesnumbervolitelnéLifetime: 10, 30, 60, 360, 1440 (default: 60)

Odpověď

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

Doručená pošta a zprávy

Čtěte příchozí emaily z dočasné schránky. Zprávy jsou načítány přes IMAP a vráceny v reálném čase.

Správa domén

Registrujte vlastní domény, ověřujte DNS a spravujte emailovou infrastrukturu. Limity domén závisí na vašem plánu.

Emailové účty

Vytvářejte, zobrazujte a spravujte emailové účty pod ověřenými doménami. Podporuje jednotlivé i hromadné vytváření s generováním náhodných uživatelských jmen.

Inteligentní extrakce ověřovacích kódů

API klíč

Automaticky extrahujte ověřovací kódy z příchozích emailů. Ideální pro automatizované testování, registrační toky a CI/CD pipeline.

Extract verification code from the latest email

Parametry

servicestringpovinnéService name (see supported list)

emailstringpovinnéEmail address to search (query param)

Odpověď

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

Podporované služby

Služba	Endpoint	Vzor kódu	Domény odesílatele
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

Potřebujete jinou službu?

Pokud služba, kterou hledáte, není uvedena výše, dejte nám vědět. Pravidelně rozšiřujeme podporované integrace na základě zpětné vazby vývojářů a můžeme přidat nové regex vzory pro jakýkoli ověřovací emailový službu.

Kontaktujte ná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"

Správa DNS

Kompletní správa DNS záznamů přes PowerDNS. Podporuje typy záznamů A, AAAA, CNAME, MX, TXT, NS, SRV a CAA. Záznamy se šíří přes 4 geograficky distribuované nameservery.

Příklady kódu

Kompletní funkční příklady pro vytváření dočasných emailů, čtení doručené pošty a extrakci ověřovacích kódů.

Tok dočasného emailu

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

Extrakce ověřovacích kódů

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"

Příklady správy domén

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

Limity rychlosti a plány

Limity plánu

Funkce	Free	Bronze	Gold	Premium
Vlastní domény	1	5	25	999
Emaily / doména	5	999	999	999
API pro dočasné emaily	Pouze web	Plný	Plný	Plný
Regex API	Pouze web	Plný	Plný	Plný
Limit rychlosti API	100/hr	1,000/hr	5,000/hr	Neomezeno
Dočasné relace / IP	10	10	10	10

Limity rychlosti endpointů

Na IP adresu

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}Dle plánu

Zpracování chyb

Všechny chybové odpovědi obsahují pole status nastavené na "error", čitelnou zprávu a volitelné messageKey pro lokalizované chybové zprávy odpovídající jazyku uživatelského účtu.

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

Kód	Stav	Popis
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

Lokalizované chybové zprávy

Použijte pole messageKey k zobrazení chyb v preferovaném jazyce uživatele. Podporováno: angličtina, turečtina, ruština, ukrajinština, polština, francouzština, němčina, ázerbájdžánština, perština, filipínština, hauština, akanština.

API Explorer

Testujte API endpointy přímo v prohlížeči. Zadejte svůj API klíč a odešlete požadavky pro zobrazení živých odpovědí.

API Explorerv1.0

evilmail.pro

POST

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

API klíč

Tělo požadavku

domain

ttlMinutes

Odešlete požadavek pro zobrazení odpovědi

Připraveni integrovat?

Získejte API klíč z nástěnky a začněte budovat. Plný přístup s jakýmkoli placeným plánem.

Začněte zdarma Zobrazit plány

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

Služba

Endpoint

Vzor kódu

Domény odesílatele

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

Funkce

Free

Bronze

Gold

Premium

Vlastní domény

999

Emaily / doména

999

API pro dočasné emaily

Pouze web

Plný

Regex API

Pouze web

Plný

Limit rychlosti API

100/hr

1,000/hr

5,000/hr

Neomezeno

Dočasné relace / IP

Kód

Stav

Popis

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