REST API · v1 · Gratuito

Email temporanea,
curl-ready.

Integra in poche righe l'email usa e getta, l'inbox temporanea e il rilevamento OTP nelle tue app. REST semplice, JSON pulito, CORS aperto, senza autenticazione.

4 endpoints
11 domini
7j conservazione
0€ costo
Prova subito Documentazione
01 / Playground

Prova direttamente dal browser

Non serve installare Postman né aprire un terminale. Scegli un endpoint, regola i parametri, esegui. La risposta reale dell'API viene mostrata in diretta.

Request
GET https://mail123.fr/api/v1/mailbox/new
Response
Clicca su Execute per lanciare la richiesta…
Request
GET https://mail123.fr/api/v1/mailbox/{address}/messages
Response
Clicca su Execute per lanciare la richiesta…
Request
GET https://mail123.fr/api/v1/mailbox/{address}/messages/{id}
Response
Clicca su Execute per lanciare la richiesta…
Request
GET https://mail123.fr/api/v1/domains

Nessun parametro. Restituisce l'elenco dei domini email attivi.

Response
Clicca su Execute per lanciare la richiesta…
02 / Endpoints

4 endpoint, 0 magia

Tutti gli endpoint usano HTTPS, restituiscono JSON UTF-8 e includono gli header X-RateLimit-* per monitorare il tuo consumo.

GET
/api/v1/mailbox/new
Genera un indirizzo email temporaneo casuale.
5/min · 50/h GET
/api/v1/mailbox/{address}/messages
Elenca le email ricevute. Include il rilevamento OTP automatico.
10/min · 50/h GET
/api/v1/mailbox/{address}/messages/{id}
Recupera il contenuto completo di un'email (testo, HTML, allegati, OTP).
10/min · 50/h GET
/api/v1/domains
Elenca i domini email disponibili.
10/min
03 / Snippet

Copia e incolla nel tuo stack

Workflow completo: crea una casella → fai il polling delle email → estrai il codice OTP. Nel linguaggio che preferisci.

# 1. Créer une boîte ADDR=$(curl -s https://mail123.fr/api/v1/mailbox/new | jq -r '.address') echo "Mailbox: $ADDR" # 2. Poller les emails (toutes les 5s) 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. Créer une boîte const { address } = await fetch('https://mail123.fr/api/v1/mailbox/new').then(r => r.json()) console.log('Mailbox:', address) // 2. Poller toutes les 5s jusqu'à recevoir un 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. Créer une boîte addr = requests.get('https://mail123.fr/api/v1/mailbox/new').json()['address'] print(f'Mailbox: {addr}') # 2. Poller jusqu'à recevoir un 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. Créer une boîte $res = json_decode(file_get_contents('https://mail123.fr/api/v1/mailbox/new'), true); $addr = $res['address']; echo "Mailbox: $addr\n"; // 2. Poller jusqu'à 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. Créer une boîte r, _ := http.Get("https://mail123.fr/api/v1/mailbox/new") var box struct{ Address string } json.NewDecoder(r.Body).Decode(&box) // 2. Poller 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. Créer une boîte addr = JSON.parse(Net::HTTP.get(URI('https://mail123.fr/api/v1/mailbox/new')))['address'] puts "Mailbox: #{addr}" # 2. Poller jusqu'à 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
04 / Quote

Gratis oggi, Pro presto

L'API pubblica gratuita copre la maggior parte degli usi personali e di test. Per volumi più elevati o un uso commerciale, un'offerta Pro arriverà a breve.

Gratuito
50 req/h
5 al minuto, par IP
  • Senza chiave API
  • CORS aperto
  • Rilevamento OTP automatico
  • 4 domini disponibili
  • JSON UTF-8 pulito
Pro · Presto
5 000 req/h
Chiave API, supporto, SLA
  • Volume 150 volte superiore
  • Webhook email ricevuta
  • Dominio personalizzato
  • Conservazione 30 giorni
  • Supporto prioritario
05 / Casi d'uso

Cosa ci fanno gli sviluppatori

Alcuni usi concreti dell'API mail123, dal test e2e all'automazione marketing. Tutti legittimi, tutti senza registrazione.

Test e2e automatizzati

Playwright, Cypress, Selenium: genera un indirizzo al volo, compila il modulo, leggi l'email di conferma, estrai il link o il codice. Ciclo completo in 30 secondi.

Bypass verifica email

Registrazioni su servizi dubbi, account usa e getta per provare una demo, accesso one-shot a contenuti dietro un email-wall — senza inquinare la tua casella principale.

Bot e automazione

Scraper che devono superare una conferma email, workflow n8n/Make/Zapier, script Selenium che automatizzano un onboarding. L'API si collega in 3 righe.

Ambienti di sviluppo

Ambienti di stage e preview: sostituisci Mailtrap, MailHog o SES con un'API pubblica. Gli sviluppatori vedono le email reali senza configurare un SMTP.

Tutorial e formazione

Demo di webhook, esercizi OAuth, corsi di sicurezza: un indirizzo usa e getta e pubblico permette ai partecipanti di fare prove senza rischi sulla loro vera casella.

Strumenti per la privacy

Estensioni del browser, gestori di password, strumenti anti-spam: integra la generazione di alias temporanei con una sola chiamata HTTP.

06 / Errors

Codici HTTP e gestione degli errori

Tutte le risposte includono un campo success: bool e un eventuale error: string. I codici HTTP seguono le convenzioni REST.

CodeSignificatoAzione
200SuccessLa risposta contiene success: true
400Bad RequestVerifica la sintassi dell'indirizzo o del parametro
403ForbiddenIndirizzo riservato (admin, root, postmaster…)
404Not FoundEmail non trovata o scaduta
429Too Many RequestsAttendi 1 minuto, o riprova dopo il reset
500Server ErrorErrore del server — riprova, altrimenti contatta il supporto
07 / FAQ

Domande frequenti

Risposte alle domande che gli sviluppatori ci pongono più spesso.

L'API è davvero gratuita?
Sì, totalmente gratuita. Niente carta di credito, niente registrazione, nessun limite nascosto. 30 richieste all'ora per indirizzo IP bastano per la maggior parte degli usi personali e di test. Per di più, l'offerta Pro arriverà a breve.
Serve una chiave API per usarla?
No. L'API pubblica funziona senza autenticazione. Per la versione Pro (in arrivo), sarà richiesta una chiave X-API-Key per beneficiare dei limiti superiori.
L'API supporta CORS?
Sì, CORS è totalmente aperto (Access-Control-Allow-Origin: *). Puoi chiamare l'API direttamente dal browser in JavaScript, senza proxy intermedio.
Per quanto tempo vengono conservate le email?
Le caselle e le loro email vengono eliminate automaticamente dopo 7 giorni di inattività. Nessun archivio persistente, nessuna archiviazione, nessun profilo utente.
L'API rileva automaticamente i codici OTP?
Sì. Ogni messaggio restituito contiene un campo otp_code. Il nostro motore di estrazione riconosce i codici numerici (da 4 a 8 cifre), alfanumerici e i formati con separatori (XX-XX, XX XX). Rilevamento contestuale: il punteggio aumenta quando parole chiave come "verification", "code", "OTP" sono presenti nelle vicinanze.
Quali domini email sono disponibili?
I domini attivi in questo momento: mail123.frmail456.frmail789.frmail123.cloudmail1mail.commail123.clickmaildaft.commail123.com.brdaftmail.cloudmailtemp.frmail123.beer. Elenco aggiornato tramite GET /api/v1/domains.
L'API supporta i webhook?
Non ancora. La versione attuale richiede il polling (GET /messages ogni 5-10 secondi). I webhook sono previsti nella versione Pro: notifica HTTPS push non appena un'email arriva in una casella che stai monitorando.
Cosa succede in caso di superamento del rate limit?
L'API restituisce un codice HTTP 429 con un header Retry-After che indica in secondi il tempo da attendere prima di riprovare. Gli header X-RateLimit-Remaining e X-RateLimit-Reset permettono di monitorare il consumo in anticipo.
Quali usi sono consentiti?
Qualsiasi uso legittimo: test automatizzati, verifiche email per account sandbox, automazione di workflow per sviluppatori, strumenti per la privacy. Gli abusi (spam, scraping massivo, frode) comportano un blocco IP definitivo senza preavviso.
Il servizio è affidabile? Qual è l'uptime?
Il servizio gira su server OVH a Roubaix, in Francia, con un uptime medio del 99,95% negli ultimi 12 mesi. Stato in tempo reale su status.mail123.fr.

Costruisci qualcosa di interessante

Niente registrazione. Niente carta di credito. Nessun webhook da configurare. Lancia la tua prima chiamata API in 10 secondi.

Prova subito Guarda anche il widget