Documentação da API

MockMail.dev REST API

Introdução

A API do MockMail permite criar caixas de email temporário, receber emails e integrar com seus sistemas de teste automatizado. Suportamos duas formas de autenticação:

API Keys (Recomendado)

Para integrações servidor-servidor. Crie no dashboard e use no headerX-API-Key

JWT Token (Legado)

Para aplicações web. Faça login e use o token no headerAuthorization: Bearer

Limites de Uso

500 requisições por dia por usuário. O contador é resetado à meia-noite UTC. Você pode verificar seu uso atual no dashboard ou nos headers de resposta:

  • X-RateLimit-Limit — Limite total
  • X-RateLimit-Remaining — Restantes
  • X-RateLimit-Reset — Timestamp do reset

Base URL

https://api.mockmail.dev/api

Para desenvolvimento local: http://localhost:3000/api

Exemplo completo de como criar uma caixa de email e aguardar um email:

# 1. Criar uma caixa de email
curl -X POST https://api.mockmail.dev/api/boxes \
  -H "X-API-Key: sua_api_key_aqui" \
  -H "Content-Type: application/json"

# Resposta: { "id": "abc123", "address": "random123", "domain": "mockmail.dev" }

# 2. Enviar um email para random123@mockmail.dev (simule em seu sistema)

# 3. Buscar o email mais recente
curl https://api.mockmail.dev/api/mail/latest/random123@mockmail.dev \
  -H "X-API-Key: sua_api_key_aqui"

# 4. Ou buscar por assunto específico
curl "https://api.mockmail.dev/api/mail/latest/random123@mockmail.dev/subject/Código%20de%20verificação" \
  -H "X-API-Key: sua_api_key_aqui"

Precisa de ajuda?

Se tiver dúvidas ou encontrar problemas, entre em contato: