A API REST do e-mail temporário

Integre e-mail descartável, caixa temporária e detecção de OTP nos seus apps com poucas linhas. REST simples, JSON limpo, CORS aberto, sem autenticação.

4 endpoints
13 domínios
7j retenção
0€ custo

Limites maiores com Premium

A API é gratuita para todos. As contas Premium têm limites de taxa multiplicados e se autenticam com sua chave de API pessoal.

Limites de taxa
Mensal ×2 10/min · 20/min
Anual ×2 10/min · 20/min
Mensal API+ ×10 50/min · 100/min
Autenticação

Obtenha sua chave de API pessoal na sua conta e passe-a no cabeçalho:

X-API-Key: m123_ak_… Seja Premium

Teste diretamente do navegador

Você não precisa do Postman nem de um terminal. Escolha um endpoint, ajuste os parâmetros e execute. A resposta real da API aparece ao vivo.

Requisição
GET https://mail123.fr/api/v1/mailbox/new
Resposta
Clique em “Executar” para enviar a requisição…
Requisição
GET https://mail123.fr/api/v1/mailbox/{address}/messages
Resposta
Clique em “Executar” para enviar a requisição…
Requisição
GET https://mail123.fr/api/v1/mailbox/{address}/messages/{id}
Resposta
Clique em “Executar” para enviar a requisição…
Requisição
GET https://mail123.fr/api/v1/domains

Sem parâmetros. Retorna a lista de domínios de e-mail ativos.

Resposta
Clique em “Executar” para enviar a requisição…

Endpoints

Todos os endpoints usam HTTPS, retornam JSON UTF-8 e incluem os cabeçalhos X-RateLimit-* para você acompanhar seu consumo.

Copie e cole na sua stack

Fluxo completo: criar uma caixa → consultar os e-mails → extrair o código OTP. Na linguagem que você preferir.

# 1. Criar uma caixa ADDR=$(curl -s https://mail123.fr/api/v1/mailbox/new | jq -r '.address') echo "Mailbox: $ADDR" # 2. Consultar a cada 5 s até receber um código OTP while true; do RESP=$(curl -s "https://mail123.fr/api/v1/mailbox/$ADDR/messages") OTP=$(echo $RESP | jq -r '.messages[0].otp_code // empty') [ -n "$OTP" ] && echo "OTP: $OTP" && break sleep 5 done
// 1. Criar uma caixa const { address } = await fetch('https://mail123.fr/api/v1/mailbox/new').then(r => r.json()) console.log('Mailbox:', address) // 2. Consultar a cada 5 s até receber um código OTP async function waitForOTP() { while (true) { const { messages } = await fetch(`https://mail123.fr/api/v1/mailbox/${address}/messages`).then(r => r.json()) const otp = messages.find(m => m.otp_code)?.otp_code if (otp) return otp await new Promise(r => setTimeout(r, 5000)) } } console.log('OTP:', await waitForOTP())
import requests, time # 1. Criar uma caixa addr = requests.get('https://mail123.fr/api/v1/mailbox/new').json()['address'] print(f'Mailbox: {addr}') # 2. Consultar a cada 5 s até receber um código OTP while True: msgs = requests.get(f'https://mail123.fr/api/v1/mailbox/{addr}/messages').json()['messages'] otp = next((m['otp_code'] for m in msgs if m.get('otp_code')), None) if otp: print(f'OTP: {otp}'); break time.sleep(5)
<?php // 1. Criar uma caixa $res = json_decode(file_get_contents('https://mail123.fr/api/v1/mailbox/new'), true); $addr = $res['address']; echo "Mailbox: $addr\n"; // 2. Consultar a cada 5 s até receber um código OTP while (true) { $msgs = json_decode(file_get_contents("https://mail123.fr/api/v1/mailbox/$addr/messages"), true)['messages']; foreach ($msgs as $m) { if (!empty($m['otp_code'])) { echo "OTP: {$m['otp_code']}\n"; exit; } } sleep(5); }
package main import ("encoding/json"; "fmt"; "net/http"; "time") func main() { // 1. Criar uma caixa r, _ := http.Get("https://mail123.fr/api/v1/mailbox/new") var box struct{ Address string } json.NewDecoder(r.Body).Decode(&box) // 2. Consultar a cada 5 s até receber um código OTP for { r, _ := http.Get("https://mail123.fr/api/v1/mailbox/" + box.Address + "/messages") var res struct{ Messages []struct{ OtpCode string `json:"otp_code"` } } json.NewDecoder(r.Body).Decode(&res) for _, m := range res.Messages { if m.OtpCode != "" { fmt.Println("OTP:", m.OtpCode); return } } time.Sleep(5 * time.Second) } }
require 'net/http'; require 'json' # 1. Criar uma caixa addr = JSON.parse(Net::HTTP.get(URI('https://mail123.fr/api/v1/mailbox/new')))['address'] puts "Mailbox: #{addr}" # 2. Consultar a cada 5 s até receber um código OTP loop do msgs = JSON.parse(Net::HTTP.get(URI("https://mail123.fr/api/v1/mailbox/#{addr}/messages")))['messages'] otp = msgs.find { |m| m['otp_code'] }&.dig('otp_code') if otp then puts "OTP: #{otp}"; break end sleep 5 end

Limites de taxa

A API pública é gratuita e limitada por IP. As contas Premium multiplicam esses limites (×2–10) e têm uma cota por conta com sua chave de API.

Grátis · por IP
50/h
sem chave, sem cadastro
  • Criar uma caixa, 5/min · 50/h
  • Ler mensagens, 10/min · 50/h
  • Domínios, 10/min
Premium · por conta
Cada plano Premium multiplica os limites gratuitos. Os limites pagos valem por conta, com o cabeçalho X-API-Key.
  • Cota por conta (não compartilhada por IP)

Limites por plano

Plano Criar uma caixa Ler mensagens Domínios
Grátis (por IP) 5/min · 50/h 10/min · 50/h 10/min
Mensal ×2 10/min · 100/h 20/min · 100/h 20/min
Anual ×2 10/min · 100/h 20/min · 100/h 20/min
Mensal API+ ×10 50/min · 500/h 100/min · 500/h 100/min

Seja Premium para multiplicar seus limites.

O que os devs constroem com isto

Usos concretos da API do mail123, de testes e2e à automação de marketing. Todos legítimos, todos sem cadastro.

Testes e2e automatizados

Playwright, Cypress, Selenium: gere um endereço na hora, preencha o formulário, leia o e-mail de confirmação e extraia o link ou o código. Ciclo completo em 30 segundos.

Contornar a verificação de e-mail

Cadastre-se em serviços duvidosos, crie contas descartáveis para testar uma demo ou acesse uma vez conteúdos que exigem e-mail, sem poluir sua caixa principal.

Bots e automação

Scrapers que precisam passar por uma confirmação de e-mail, fluxos n8n/Make/Zapier, scripts Selenium que automatizam o onboarding. A API se integra com 3 linhas.

Ambientes de desenvolvimento

Ambientes de staging e preview: troque Mailtrap, MailHog ou SES por uma API pública. O time vê e-mails reais sem configurar SMTP.

Tutoriais e cursos

Demos de webhooks, exercícios de OAuth, treinamento em segurança: um endereço público descartável permite praticar sem arriscar a caixa de e-mail real.

Ferramentas de privacidade

Extensões de navegador, gerenciadores de senhas, ferramentas antispam: integre a geração de aliases em uma única chamada HTTP.

Códigos HTTP e tratamento de erros

Todas as respostas incluem um campo success: bool e um campo opcional error: string. Os códigos HTTP seguem as convenções REST.

CodeSignificadoAção
200SuccessA resposta inclui success: true
400Bad RequestVerifique a sintaxe do endereço ou do parâmetro
403ForbiddenEndereço reservado (admin, root, postmaster…)
404Not FoundE-mail não encontrado ou expirado
429Too Many RequestsAguarde 1 minuto ou tente de novo após a reposição
500Server ErrorErro do servidor: tente de novo e, se persistir, fale com o suporte

Perguntas frequentes

Respostas às perguntas que os desenvolvedores mais nos fazem.

A API é mesmo gratuita?
Sim, totalmente gratuita. Sem cartão, sem cadastro e sem limites escondidos. 30 requisições por hora por IP cobrem a maioria dos usos pessoais e de teste. Para mais, o plano Pro está a caminho.
Preciso de uma chave de API?
Não. A API pública funciona sem autenticação. Com o Pro (em breve), um cabeçalho X-API-Key vai liberar limites maiores.
A API aceita CORS?
Sim, o CORS está totalmente aberto (Access-Control-Allow-Origin: *). Você pode chamar a API direto do navegador, em JavaScript, sem proxy.
Por quanto tempo os e-mails são guardados?
Os e-mails são apagados automaticamente 7 dias após o recebimento. Já o endereço continua utilizável sem limite. Sem armazenamento persistente dos e-mails, sem arquivo, sem perfil de usuário.
A API detecta os códigos OTP automaticamente?
Sim. Cada mensagem retornada inclui um campo otp_code. Nosso extrator reconhece códigos numéricos (4-8 dígitos), alfanuméricos e formatos com separador (XX-XX, XX XX). Ele considera o contexto: a pontuação sobe quando há palavras como “verificação”, “código” ou “OTP” por perto.
Quais domínios de e-mail estão disponíveis?
Domínios ativos no momento: mail123.frmail456.frmail789.frmail1mail.commail123.clickmail123.com.brmail123.beermail123box.techmail123.promail123.sitemail123.onlinemail123.techmail123.website. Lista ao vivo com GET /api/v1/domains.
A API aceita webhooks?
Ainda não. A versão atual exige polling (GET /messages a cada 5-10 segundos). Os webhooks estão previstos no Pro: notificações push HTTPS quando chegam e-mails nas caixas que você acompanha.
O que acontece se eu atingir o limite de requisições?
A API retorna HTTP 429 com um cabeçalho Retry-After que indica, em segundos, quando tentar de novo. Os cabeçalhos X-RateLimit-Remaining e X-RateLimit-Reset permitem acompanhar o consumo.
Quais usos são permitidos?
Qualquer uso legítimo: testes automatizados, verificação de contas em sandbox, automação do fluxo de desenvolvimento, ferramentas de privacidade. Abusos (spam, scraping em massa, fraude) resultam em bloqueio permanente do IP sem aviso.
O serviço é confiável? Qual a disponibilidade?
O serviço roda em servidores OVH em Roubaix, França, com 99,95 % de disponibilidade média nos últimos 12 meses. Status em tempo real em status.mail123.fr.

Construa algo legal

Sem cadastro. Sem cartão. Sem configurar webhooks. Faça sua primeira chamada à API em 10 segundos.