Документація для розробників

Довідник API EvilMail

Інтегруйте одноразову пошту, власні домени, читання вхідних, управління DNS та розумне витягнення кодів підтвердження у ваші додатки.

Базовий URL:https://evilmail.pro

Формат:JSON

Автентифікація:API-ключ / Сесія

Протоколи:Тільки HTTPS

Огляд

API EvilMail надає програмний доступ до всіх функцій платформи. Створюйте одноразові email, керуйте власними доменами, читайте вхідні, витягуйте коди підтвердження та керуйте DNS-записами — все через простий RESTful інтерфейс.

API тимчасової пошти

Створення одноразових скриньок, читання повідомлень, автоматичне закінчення терміну

API доменів та пошти

Власні домени, поштові акаунти, управління DNS

Regex-витягнення

Автоматичне витягнення кодів підтвердження від 8+ сервісів

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

Формат відповіді

Усі відповіді дотримуються єдиної структури JSON:

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

Відповіді з помилками містять messageKey для локалізованих повідомлень про помилки відповідно до мови акаунту користувача.

Автентифікація

EvilMail використовує два методи автентифікації залежно від типу ендпоінта. Усі API-запити повинні виконуватися через HTTPS.

API-ключ

Для створення тимчасової пошти та витягнення кодів підтвердження. Потрібна активна платна підписка.

X-API-Key: your_64char_hex_key

Сесійний Cookie

Для ендпоінтів управління доменами, поштовими акаунтами та DNS. Встановлюється після входу.

Cookie: evilmail_session=...

API тимчасової пошти вимагає платний план

API тимчасової пошти та ендпоінти regex-витягнення потребують активну підписку Бронзовий, Золотий або Преміум. Безкоштовні акаунти можуть використовувати лише веб-інтерфейс.

Тимчасова пошта

Потрібен платний план

Створення одноразових email-адрес з налаштовуваним TTL. Доступні домени: evilmail.pro, evilmail.cloud.

Create a temporary email address

Тіло запиту

domainstringнеобов'язковоDomain to use (default: evilmail.pro)

ttlMinutesnumberнеобов'язковоLifetime: 10, 30, 60, 360, 1440 (default: 60)

Відповідь

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

Вхідні та повідомлення

Читання вхідних листів з вашої тимчасової скриньки. Повідомлення отримуються через IMAP та повертаються в реальному часі.

Управління доменами

Реєстрація власних доменів, перевірка DNS та управління поштовою інфраструктурою. Ліміти доменів залежать від вашого плану.

Поштові акаунти

Створення, перегляд та управління поштовими акаунтами під вашими верифікованими доменами. Підтримується одиничне та пакетне створення з генерацією випадкових імен користувачів.

Розумне витягнення кодів підтвердження

API-ключ

Автоматичне витягнення кодів підтвердження з вхідних листів. Ідеально для автоматизованого тестування, потоків реєстрації акаунтів та CI/CD пайплайнів.

Extract verification code from the latest email

Параметри

servicestringобов'язковоService name (see supported list)

emailstringобов'язковоEmail address to search (query param)

Відповідь

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

Підтримувані сервіси

Сервіс	Ендпоінт	Шаблон коду	Домени відправника
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

Потрібен інший сервіс?

Якщо потрібного вам сервісу немає у списку вище, повідомте нам. Ми регулярно розширюємо підтримувані інтеграції на основі відгуків розробників і можемо додати нові regex-шаблони для будь-якого сервісу верифікації електронною поштою.

Зв'язатися з нами

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

Повне управління DNS-записами через PowerDNS. Підтримуються типи записів A, AAAA, CNAME, MX, TXT, NS, SRV та CAA. Записи поширюються через 4 географічно розподілені неймсервери.

Приклади коду

Повні робочі приклади для створення тимчасової пошти, читання вхідних та витягнення кодів підтвердження.

Потік тимчасової пошти

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

Витягнення кодів підтвердження

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"

Приклади управління доменами

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

Ліміти запитів та плани

Ліміти планів

Функція	Free	Bronze	Gold	Premium
Власні домени	1	5	25	999
Email / Домен	5	999	999	999
API тимчасової пошти	Тільки веб	Повний	Повний	Повний
Regex API	Тільки веб	Повний	Повний	Повний
Ліміт API-запитів	100/hr	1,000/hr	5,000/hr	Безлімітно
Тимчасові сесії / IP	10	10	10	10

Ліміти запитів ендпоінтів

На 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}Залежно від плану

Обробка помилок

Усі відповіді з помилками містять поле status зі значенням "error", зрозуміле повідомлення та необов'язковий messageKey для локалізованих повідомлень про помилки відповідно до мови акаунту користувача.

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

Код	Статус	Опис
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

Локалізовані повідомлення про помилки

Використовуйте поле messageKey для відображення помилок мовою, яку обрав користувач. Підтримуються: англійська, турецька, російська, українська, польська, французька, німецька, азербайджанська, перська, філіппінська, хауса, акан.

API Explorer

Тестуйте API-ендпоінти прямо з браузера. Введіть ваш API-ключ та надсилайте запити для отримання відповідей у реальному часі.

API Explorerv1.0

evilmail.pro

POST

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

API-ключ

Тіло запиту

domain

ttlMinutes

Надішліть запит, щоб побачити відповідь

Готові до інтеграції?

Отримайте API-ключ у панелі керування та починайте розробку. Повний доступ з будь-яким платним планом.

Почати безкоштовно Переглянути плани

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

Сервіс

Ендпоінт

Шаблон коду

Домени відправника

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

Функція

Free

Bronze

Gold

Premium

Власні домени

999

Email / Домен

999

API тимчасової пошти

Тільки веб

Повний

Regex API

Тільки веб

Повний

Ліміт API-запитів

100/hr

1,000/hr

5,000/hr

Безлімітно

Тимчасові сесії / IP

Код

Статус

Опис

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