Dokumentacja deweloperska

Dokumentacja API

Zintegruj EvilMail ze swoimi aplikacjami

Bazowy URL:https://evilmail.pro

Format:JSON

Autoryzacja:Klucz API / Sesja

Protokoły:Tylko HTTPS

Przegląd

API EvilMail zapewnia programowy dostęp do wszystkich funkcji platformy. Twórz jednorazowe e-maile, zarządzaj własnymi domenami, czytaj skrzynki, wyodrębniaj kody weryfikacyjne i kontroluj rekordy DNS — wszystko przez prosty interfejs RESTful.

API tymczasowych e-maili

Twórz jednorazowe skrzynki, czytaj wiadomości, automatyczne wygasanie

API domen i e-maili

Własne domeny, konta e-mail, zarządzanie DNS

Ekstrakcja Regex

Automatyczna ekstrakcja kodów weryfikacyjnych z 8+ usług

Official SDK Libraries

Node.js

npm install evilmail

npmjs.com/package/evilmail

Python

pip install evilmail

pypi.org/project/evilmail

PHP

composer require evilmail/evilmail-php

packagist.org

go get github.com/Evil-Mail/evilmail-go

pkg.go.dev

Format odpowiedzi

Wszystkie odpowiedzi mają spójną strukturę JSON:

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

Odpowiedzi błędów zawierają messageKey do zlokalizowanych komunikatów błędów.

Uwierzytelnianie

Wszystkie żądania API wymagają klucza API przekazywanego przez nagłówek X-API-Key. Pobierz swój klucz API z panelu po rejestracji.

Klucz API

Do tworzenia tymczasowych e-maili i ekstrakcji kodów weryfikacyjnych. Wymaga aktywnej płatnej subskrypcji.

X-API-Key: your_64char_hex_key

Ciasteczko sesji

Do endpointów zarządzania domenami, kontami e-mail i DNS. Ustawiane po zalogowaniu.

Cookie: evilmail_session=...

API tymczasowych e-maili wymaga planu płatnego

API tymczasowych e-maili i endpointy ekstrakcji regex wymagają aktywnej subskrypcji Bronze, Gold lub Premium.

Tymczasowy e-mail

Wymagany plan płatny

Twórz jednorazowe adresy e-mail z konfigurowalnym TTL. Dostępne domeny: evilmail.pro, evilmail.cloud.

Create a temporary email address

Treść żądania

domainstringopcjonalnyDomain to use (default: evilmail.pro)

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

Odpowiedź

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

Skrzynka i wiadomości

Odczytuj przychodzące e-maile z tymczasowej skrzynki. Wiadomości pobierane przez IMAP w czasie rzeczywistym.

Zarządzanie domenami

Rejestruj własne domeny, weryfikuj DNS i zarządzaj infrastrukturą e-mail. Limity domen zależą od Twojego planu.

Konta e-mail

Twórz, wyświetlaj i zarządzaj kontami e-mail w swoich zweryfikowanych domenach. Obsługuje pojedyncze i grupowe tworzenie z losową generacją nazw użytkowników.

Inteligentna ekstrakcja kodów weryfikacyjnych

Klucz API

Automatyczna ekstrakcja kodów weryfikacyjnych z przychodzących e-maili. Idealne do automatycznego testowania i pipeline'ów CI/CD.

Extract verification code from the latest email

Parametry

servicestringwymaganyService name (see supported list)

emailstringwymaganyEmail address to search (query param)

Odpowiedź

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

Obsługiwane usługi

Usługa	Endpoint	Wzorzec kodu	Domeny nadawcy
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

Potrzebujesz innej usługi?

Jeśli usługa, której szukasz, nie jest wymieniona powyżej, daj nam znać. Regularnie rozszerzamy wspierane integracje.

Skontaktuj się z nami

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"

Zarządzanie DNS

Pełne zarządzanie rekordami DNS przez PowerDNS. Obsługuje typy rekordów A, AAAA, CNAME, MX, TXT, NS, SRV i CAA. Rekordy propagowane przez 4 geograficznie rozproszone serwery nazw.

Przykłady kodu

Kompletne przykłady tworzenia tymczasowych e-maili, odczytywania skrzynek i ekstrakcji kodów weryfikacyjnych.

Przepływ tymczasowego e-maila

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

Ekstrakcja kodów weryfikacyjnych

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"

Przykłady zarządzania domenami

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 i plany

Limity planu

Funkcja	Free	Bronze	Gold	Premium
Własne domeny	1	5	25	999
E-maile / domena	5	999	999	999
API tymczasowych e-maili	Tylko web	Pełny	Pełny	Pełny
API Regex	Tylko web	Pełny	Pełny	Pełny
Limit żądań API	100/hr	1,000/hr	5,000/hr	Bez limitu
Sesje tymczasowe / IP	10	10	10	10

Limity żądań endpointów

Na 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}Zależne od planu

Obsługa błędów

Wszystkie odpowiedzi błędów zawierają pole status ustawione na "error", czytelną wiadomość oraz opcjonalny messageKey do zlokalizowanych komunikatów błędów.

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

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

Zlokalizowane komunikaty błędów

Użyj pola messageKey do wyświetlania błędów w preferowanym języku użytkownika.

Eksplorator API

Testuj endpointy API bezpośrednio z przeglądarki. Wprowadź swój klucz API i wysyłaj żądania, aby zobaczyć odpowiedzi na żywo.

Eksplorator APIv1.0

evilmail.pro

POST

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

Klucz API

Treść żądania

domain

ttlMinutes

Wyślij żądanie, aby zobaczyć odpowiedź

Gotowy do integracji?

Pobierz klucz API z panelu i zacznij budować. Pełny dostęp z każdym planem płatnym.

Rozpocznij za darmo Zobacz plany

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

Usługa

Endpoint

Wzorzec kodu

Domeny nadawcy

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

Funkcja

Free

Bronze

Gold

Premium

Własne domeny

999

E-maile / domena

999

API tymczasowych e-maili

Tylko web

Pełny

API Regex

Tylko web

Pełny

Limit żądań API

100/hr

1,000/hr

5,000/hr

Bez limitu

Sesje tymczasowe / IP

Kod

Status

Opis

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