L'API est-elle vraiment gratuite ?

Oui, totalement gratuite. Pas de carte bancaire, pas d'inscription, pas de limite cachée. Les limites par IP (5 à 10 requêtes/min, 50/h) suffisent pour la plupart des usages personnels et de test.

Faut-il une clé API pour l'utiliser ?

Non, l'API publique fonctionne sans clé. Les comptes Premium obtiennent des limites multipliées et une clé personnelle à passer via l'en-tête X-API-Key.

L'API supporte-t-elle CORS ?

Oui, CORS est ouvert (Access-Control-Allow-Origin: *). Vous pouvez l'appeler directement depuis un navigateur en JavaScript sans proxy.

Combien de temps les emails sont-ils conservés ?

Les emails sont automatiquement supprimés 7 jours après leur réception. L'adresse, elle, reste utilisable sans limite. Pas de stockage persistant des mails.

L'API détecte-t-elle les codes OTP automatiquement ?

Oui, chaque message renvoyé contient un champ otp_code qui extrait automatiquement les codes de vérification (chiffres, alphanumériques, formats XX-XX) du contenu de l'email.

Puis-je utiliser l'API pour automatiser des inscriptions ?

L'API est destinée à des usages légitimes : tests e2e, vérifications email, sandbox développeur. Les abus (spam, fraude) entraînent un blocage IP définitif.

Quels domaines email sont disponibles ?

14 domaines actifs dont mail123.fr. Liste complète via GET /api/v1/domains.

L'API supporte-t-elle webhooks ?

Pas encore. Pour l'instant, il faut poller GET /messages toutes les 5-10 secondes. Les webhooks arriveront dans la version Pro.

L'API REST per l'email temporanea

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

14 domini

7j conservazione

0€ costo

Prova subito Documentazione

~/dev, curl

# Crea una casella di posta

$ curl https://mail123.fr/api/v1/mailbox/new

"address": "swift-fox-k7m2qx@mail123.fr",
"domain": "mail123.fr"

# Leggi i messaggi ricevuti

$ curl .../messages

"from": "noreply@github.com",
"subject": "Verify your email",
"otp_code": "AB3-XK9" ← rilevato

Limiti più alti con Premium

L'API è gratuita per tutti. Gli account Premium hanno limiti di frequenza moltiplicati e si autenticano con la loro chiave API personale.

Limiti di frequenza

Mensile ×2 10/min · 20/min

Annuale ×2 10/min · 20/min

Mensile API+ ×10 50/min · 100/min

Limiti per piano

Autenticazione

Recupera la tua chiave API personale dal tuo account e passala come header:

X-API-Key: m123_ak_… Passa a Premium

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.

Richiesta

GET https://mail123.fr/api/v1/mailbox/new

?domain=

Risposta

Premi «Esegui» per inviare la richiesta…

Richiesta

GET https://mail123.fr/api/v1/mailbox/{address}/messages

address

?limit=

Risposta

Premi «Esegui» per inviare la richiesta…

Richiesta

GET https://mail123.fr/api/v1/mailbox/{address}/messages/{id}

address

Risposta

Premi «Esegui» per inviare la richiesta…

Richiesta

GET https://mail123.fr/api/v1/domains

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

Risposta

Premi «Esegui» per inviare la richiesta…

Endpoint

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

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. Crea una casella ADDR=$(curl -s https://mail123.fr/api/v1/mailbox/new | jq -r '.address') echo "Mailbox: $ADDR" # 2. Interroga ogni 5 s finché non arriva un codice 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. Crea una casella
const { address } = await fetch('https://mail123.fr/api/v1/mailbox/new').then(r => r.json())
console.log('Mailbox:', address)

// 2. Interroga ogni 5 s finché non arriva un codice 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. Crea una casella
addr = requests.get('https://mail123.fr/api/v1/mailbox/new').json()['address']
print(f'Mailbox: {addr}')

# 2. Interroga ogni 5 s finché non arriva un codice 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. Crea una casella
$res = json_decode(file_get_contents('https://mail123.fr/api/v1/mailbox/new'), true);
$addr = $res['address'];
echo "Mailbox: $addr\n";

// 2. Interroga ogni 5 s finché non arriva un codice 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. Crea una casella
    r, _ := http.Get("https://mail123.fr/api/v1/mailbox/new")
    var box struct{ Address string }
    json.NewDecoder(r.Body).Decode(&box)

    // 2. Interroga ogni 5 s finché non arriva un codice 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. Crea una casella
addr = JSON.parse(Net::HTTP.get(URI('https://mail123.fr/api/v1/mailbox/new')))['address']
puts "Mailbox: #{addr}"

# 2. Interroga ogni 5 s finché non arriva un codice 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

Limiti di frequenza

L'API pubblica è gratuita e limitata per IP. Gli account Premium moltiplicano questi limiti (×2–10) e hanno una quota per account tramite la loro chiave API.

Gratuito · per IP

50/h

senza chiave, senza registrazione

Crea una casella, 5/min · 50/h
Leggi i messaggi, 10/min · 50/h
Domini, 10/min

Premium · per account

Ogni piano Premium moltiplica i limiti gratuiti. I limiti a pagamento valgono per account, con l'intestazione X-API-Key.

Quota per account (non condivisa per IP)

Limiti per piano

Piano	Crea una casella	Leggi i messaggi	Domini
Gratis (per IP)	5/min · 50/h	10/min · 50/h	10/min
Mensile ×2	10/min · 100/h	20/min · 100/h	20/min
Annuale ×2	10/min · 100/h	20/min · 100/h	20/min
Mensile API+ ×10	50/min · 500/h	100/min · 500/h	100/min

Passa a Premium per moltiplicare i tuoi limiti.

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.

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.

Code	Significato	Azione
200	Success	La risposta contiene success: true
400	Bad Request	Verifica la sintassi dell'indirizzo o del parametro
403	Forbidden	Indirizzo riservato (admin, root, postmaster…)
404	Not Found	Email non trovata o scaduta
429	Too Many Requests	Attendi 1 minuto, o riprova dopo il reset
500	Server Error	Errore del server, riprova, altrimenti contatta il supporto

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 email vengono eliminate automaticamente 7 giorni dopo la ricezione. L'indirizzo invece resta utilizzabile senza limiti. Nessuna conservazione persistente delle email, nessun archivio, 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.frmail1mail.commail123.clickmail123.com.brdaftmail.cloudmail123.beermail123box.techmail123.promail123.sitemail123.onlinemail123.techmail123.website. 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