Documentação para Desenvolvedores

Referência da API EvilMail

Integre e-mail descartável, domínios personalizados, leitura de caixa de entrada, gerenciamento DNS e extração inteligente de códigos de verificação em seus aplicativos.

URL Base:https://evilmail.pro

Formato:JSON

Autenticação:API Key / Sessão

Protocolos:Somente HTTPS

Visão Geral

A API do EvilMail oferece acesso programático a todos os recursos da plataforma. Crie e-mails descartáveis, gerencie domínios personalizados, leia caixas de entrada, extraia códigos de verificação e controle registros DNS — tudo através de uma interface RESTful simples.

API de E-mail Temporário

Crie caixas de entrada descartáveis, leia mensagens, expiração automática

API de Domínios e E-mail

Domínios personalizados, contas de e-mail, gerenciamento DNS

Extração Regex

Extração automática de códigos de verificação de mais de 8 serviços

Formato de Resposta

Todas as respostas seguem uma estrutura JSON consistente:

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

Respostas de erro incluem messageKey para mensagens de erro localizadas correspondentes ao idioma da conta do usuário.

Autenticação

O EvilMail utiliza dois métodos de autenticação dependendo do tipo de endpoint. Todas as requisições da API devem ser feitas via HTTPS.

API Key

Para criação de e-mail temporário e extração de código de verificação. Requer uma assinatura paga ativa.

X-API-Key: your_64char_hex_key

Cookie de Sessão

Para endpoints de gerenciamento de domínios, contas de e-mail e DNS. Definido após o login.

Cookie: evilmail_session=...

A API de E-mail Temporário requer um plano pago

Os endpoints de API de e-mail temporário e extração regex requerem uma assinatura ativa Bronze, Gold ou Premium. Contas gratuitas podem usar apenas a interface web.

E-mail Temporário

Plano Pago Necessário

Crie endereços de e-mail descartáveis com TTL configurável. Domínios disponíveis: evilmail.pro, evilmail.cloud.

Create a temporary email address

Corpo da Requisição

domainstringopcionalDomain to use (default: evilmail.pro)

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

Resposta

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

Caixa de Entrada e Mensagens

Leia e-mails recebidos da sua caixa de entrada temporária. As mensagens são obtidas via IMAP e retornadas em tempo real.

Gerenciamento de Domínios

Registre domínios personalizados, verifique DNS e gerencie sua infraestrutura de e-mail. Os limites de domínio dependem do seu plano.

Contas de E-mail

Crie, liste e gerencie contas de e-mail sob seus domínios verificados. Suporta criação individual e em lote com geração aleatória de nome de usuário.

Extração Inteligente de Códigos de Verificação

API Key

Extraia automaticamente códigos de verificação de e-mails recebidos. Perfeito para testes automatizados, fluxos de registro de contas e pipelines CI/CD.

Extract verification code from the latest email

Parâmetros

servicestringobrigatórioService name (see supported list)

emailstringobrigatórioEmail address to search (query param)

Resposta

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

Serviços Suportados

Serviço	Endpoint	Padrão do Código	Domínios do Remetente
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

Precisa de um Serviço Diferente?

Se o serviço que você procura não está listado acima, nos avise. Expandimos regularmente nossas integrações suportadas com base no feedback dos desenvolvedores e podemos adicionar novos padrões regex para qualquer serviço de verificação por e-mail.

Fale Conosco

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"

Gerenciamento DNS

Gerenciamento completo de registros DNS via PowerDNS. Suporta tipos de registro A, AAAA, CNAME, MX, TXT, NS, SRV e CAA. Os registros são propagados por 4 nameservers geograficamente distribuídos.

Exemplos de Código

Exemplos completos e funcionais para criar e-mails temporários, ler caixas de entrada e extrair códigos de verificação.

Fluxo de E-mail Temporário

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

Extração de Código de Verificação

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"

Exemplos de Gerenciamento de Domínios

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

Limites de Taxa e Planos

Limites do Plano

Recurso	Free	Bronze	Gold	Premium
Domínios Personalizados	1	5	25	999
E-mails / Domínio	5	999	999	999
API de E-mail Temporário	Somente web	Completo	Completo	Completo
Regex API	Somente web	Completo	Completo	Completo
Limite de Taxa da API	100/hr	1,000/hr	5,000/hr	Ilimitado
Sessões Temporárias / IP	10	10	10	10

Limites de Taxa por Endpoint

Por endereço 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}Baseado no plano

Tratamento de Erros

Todas as respostas de erro incluem um campo status definido como "error", uma mensagem legível e um messageKey opcional para mensagens de erro localizadas correspondentes ao idioma da conta do usuário.

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

Código	Status	Descrição
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

Mensagens de Erro Localizadas

Use o campo messageKey para exibir erros no idioma preferido do usuário. Suportados: inglês, turco, russo, ucraniano, polonês, francês, alemão, azerbaijano, persa, filipino, hauçá, akan.

API Explorer

Teste endpoints da API diretamente do seu navegador. Insira sua chave de API e envie requisições para ver respostas em tempo real.

API Explorerv1.0

evilmail.pro

POST

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

API Key

Corpo da Requisição

domain

ttlMinutes

Envie uma requisição para ver a resposta

Pronto para integrar?

Obtenha sua chave de API no painel e comece a construir. Acesso completo com qualquer plano pago.

Comece Gratuitamente Ver Planos

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

Serviço

Endpoint

Padrão do Código

Domínios do Remetente

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

Recurso

Free

Bronze

Gold

Premium

Domínios Personalizados

999

E-mails / Domínio

999

API de E-mail Temporário

Somente web

Completo

Regex API

Somente web

Completo

Limite de Taxa da API

100/hr

1,000/hr

5,000/hr

Ilimitado

Sessões Temporárias / IP

Código

Status

Descrição

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