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

Справочник 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