A API REST do email temporário

Integre o email descartável, a caixa temporária e a deteção de OTP nas suas aplicações com poucas linhas. REST simples, JSON limpo, CORS aberto, sem autenticação.

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

Limites mais elevados com Premium

A API é gratuita para todos. As contas Premium têm limites de taxa multiplicados e autenticam-se com a sua chave 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 a sua chave API pessoal na sua conta e passe-a no cabeçalho:

X-API-Key: m123_ak_… Tornar-se Premium

Teste diretamente do navegador

Não precisa de Postman nem de um terminal. Escolha um endpoint, ajuste os parâmetros e execute. A resposta real da API aparece em direto.

Pedido
GET https://mail123.fr/api/v1/mailbox/new
Resposta
Clique em «Executar» para enviar o pedido…
Pedido
GET https://mail123.fr/api/v1/mailbox/{address}/messages
Resposta
Clique em «Executar» para enviar o pedido…
Pedido
GET https://mail123.fr/api/v1/mailbox/{address}/messages/{id}
Resposta
Clique em «Executar» para enviar o pedido…
Pedido
GET https://mail123.fr/api/v1/domains

Sem parâmetros. Devolve a lista de domínios de email ativos.

Resposta
Clique em «Executar» para enviar o pedido…

Endpoints

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

Copie e cole na sua stack

Fluxo completo: criar uma caixa → consultar os emails → extrair o código OTP. Na linguagem que preferir.

# 1. Criar uma caixa ADDR=$(curl -s https://mail123.fr/api/v1/mailbox/new | jq -r '.address') echo "Mailbox: $ADDR" # 2. Consultar de 5 em 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 de 5 em 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 de 5 em 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 de 5 em 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 de 5 em 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 de 5 em 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 estes limites (×2–10) e têm uma quota por conta com a sua chave API.

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

Limites por oferta

Oferta 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

Tornar-se Premium para multiplicar os seus limites.

O que os devs constroem com isto

Utilizações concretas da API do mail123, dos testes e2e à automação de marketing. Todas legítimas, todas sem registo.

Testes e2e automatizados

Playwright, Cypress, Selenium: gere um endereço em tempo real, preencha o formulário, leia o email de confirmação e extraia a ligação ou o código. Ciclo completo em 30 segundos.

Contornar a verificação de email

Registo em serviços duvidosos, contas descartáveis para experimentar uma demo ou acesso pontual a conteúdos que exigem email, sem poluir a caixa principal.

Bots e automação

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

Ambientes de desenvolvimento

Ambientes de staging e preview: substitua o Mailtrap, o MailHog ou o SES por uma API pública. A equipa vê emails reais sem configurar SMTP.

Tutoriais e formações

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

Ferramentas de privacidade

Extensões de navegador, gestores de palavras-passe, ferramentas antispam: integre a geração de alias numa ú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 FoundEmail não encontrado ou expirado
429Too Many RequestsAguarde 1 minuto ou tente novamente após a reposição
500Server ErrorErro do servidor: tente novamente e, se persistir, contacte o suporte

Perguntas frequentes

Respostas às perguntas que os programadores mais nos colocam.

A API é mesmo gratuita?
Sim, totalmente gratuita. Sem cartão, sem registo e sem limites ocultos. 30 pedidos por hora e por IP cobrem a maioria das utilizações pessoais e de teste. Para mais, em breve haverá o plano Pro.
Preciso de uma chave API?
Não. A API pública funciona sem autenticação. Com o Pro (em breve), um cabeçalho X-API-Key desbloqueará limites mais elevados.
A API suporta CORS?
Sim, o CORS está totalmente aberto (Access-Control-Allow-Origin: *). Pode chamar a API diretamente a partir do navegador em JavaScript, sem proxy.
Durante quanto tempo são guardados os emails?
Os emails são eliminados automaticamente 7 dias após a receção. O endereço, esse, continua utilizável sem limite. Sem armazenamento persistente dos emails, sem arquivo, sem perfil de utilizador.
A API deteta os códigos OTP automaticamente?
Sim. Cada mensagem devolvida inclui um campo otp_code. O nosso extrator reconhece códigos numéricos (4-8 dígitos), alfanuméricos e formatos com separador (XX-XX, XX XX). Tem em conta o contexto: a pontuação sobe quando há palavras como «verificação», «código» ou «OTP» por perto.
Que domínios de email estão disponíveis?
Domínios atualmente ativos: mail123.frmail456.frmail789.frmail1mail.commail123.clickmail123.com.brmail123.beermail123box.techmail123.promail123.sitemail123.onlinemail123.techmail123.website. Lista em direto com GET /api/v1/domains.
A API suporta 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 emails às caixas que acompanha.
O que acontece se atingir o limite de pedidos?
A API devolve 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.
Que utilizações são permitidas?
Qualquer utilização legítima: testes automatizados, verificação de contas de sandbox, automação do fluxo de desenvolvimento, ferramentas de privacidade. Os abusos (spam, scraping massivo, fraude) resultam num bloqueio permanente do IP sem aviso prévio.
O serviço é fiável? Que disponibilidade tem?
O serviço funciona em servidores OVH em Roubaix, França, com 99,95 % de disponibilidade média nos últimos 12 meses. Estado em tempo real em status.mail123.fr.

Construa algo fantástico

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