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.

Die REST-API für temporäre E-Mail

Integrieren Sie Wegwerf-E-Mail, temporären Posteingang und OTP-Erkennung mit nur wenigen Zeilen in Ihre Apps. Einfaches REST, sauberes JSON, offenes CORS, ohne Authentifizierung.

4 endpoints

14 Domains

7j Aufbewahrung

0€ Kosten

Jetzt ausprobieren Dokumentation

~/dev, curl

# Postfach erstellen

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

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

# Empfangene Nachrichten lesen

$ curl .../messages

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

Höhere Limits mit Premium

Die API ist für alle kostenlos. Premium-Konten erhalten vervielfachte Rate-Limits und authentifizieren sich mit ihrem persönlichen API-Schlüssel.

Rate-Limits

Monatlich ×2 10/min · 20/min

Jährlich ×2 10/min · 20/min

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

Limits je Tarif

Authentifizierung

Holen Sie Ihren persönlichen API-Schlüssel aus Ihrem Konto und übergeben Sie ihn im Header:

X-API-Key: m123_ak_… Premium werden

Testen Sie direkt im Browser

Kein Postman installieren, kein Terminal öffnen. Wählen Sie einen Endpoint, passen Sie die Parameter an, führen Sie ihn aus. Die echte API-Antwort wird live angezeigt.

Anfrage

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

?domain=

Antwort

Klicken Sie auf „Ausführen“, um die Anfrage zu senden…

Anfrage

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

address

?limit=

Antwort

Klicken Sie auf „Ausführen“, um die Anfrage zu senden…

Anfrage

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

address

Antwort

Klicken Sie auf „Ausführen“, um die Anfrage zu senden…

Anfrage

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

Keine Parameter. Gibt die Liste der aktiven E-Mail-Domains zurück.

Antwort

Klicken Sie auf „Ausführen“, um die Anfrage zu senden…

Endpunkte

Alle Endpoints nutzen HTTPS, geben UTF-8-JSON zurück und enthalten die X-RateLimit-*-Header, um Ihren Verbrauch zu verfolgen.

GET

/api/v1/mailbox/new

Generiert eine zufällige temporäre E-Mail-Adresse.

5/min · 50/h GET

/api/v1/mailbox/{address}/messages

Listet die empfangenen E-Mails auf. Enthält die automatische OTP-Erkennung.

10/min · 50/h GET

/api/v1/mailbox/{address}/messages/{id}

Ruft den vollständigen Inhalt einer E-Mail ab (Text, HTML, Anhänge, OTP).

10/min · 50/h GET

/api/v1/domains

Listet die verfügbaren E-Mail-Domains auf.

10/min

Copy-paste in Ihren Stack

Kompletter Workflow: Postfach erstellen → E-Mails pollen → OTP-Code extrahieren. In der Sprache Ihrer Wahl.

# 1. Postfach erstellen ADDR=$(curl -s https://mail123.fr/api/v1/mailbox/new | jq -r '.address') echo "Mailbox: $ADDR" # 2. Alle 5 s abfragen, bis ein OTP-Code eintrifft 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. Postfach erstellen
const { address } = await fetch('https://mail123.fr/api/v1/mailbox/new').then(r => r.json())
console.log('Mailbox:', address)

// 2. Alle 5 s abfragen, bis ein OTP-Code eintrifft
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. Postfach erstellen
addr = requests.get('https://mail123.fr/api/v1/mailbox/new').json()['address']
print(f'Mailbox: {addr}')

# 2. Alle 5 s abfragen, bis ein OTP-Code eintrifft
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. Postfach erstellen
$res = json_decode(file_get_contents('https://mail123.fr/api/v1/mailbox/new'), true);
$addr = $res['address'];
echo "Mailbox: $addr\n";

// 2. Alle 5 s abfragen, bis ein OTP-Code eintrifft
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. Postfach erstellen
    r, _ := http.Get("https://mail123.fr/api/v1/mailbox/new")
    var box struct{ Address string }
    json.NewDecoder(r.Body).Decode(&box)

    // 2. Alle 5 s abfragen, bis ein OTP-Code eintrifft
    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. Postfach erstellen
addr = JSON.parse(Net::HTTP.get(URI('https://mail123.fr/api/v1/mailbox/new')))['address']
puts "Mailbox: #{addr}"

# 2. Alle 5 s abfragen, bis ein OTP-Code eintrifft
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

Rate-Limits

Die öffentliche API ist kostenlos und pro IP begrenzt. Premium-Konten vervielfachen diese Limits (×2–10) und erhalten ein Kontingent pro Konto über ihren API-Schlüssel.

Kostenlos · pro IP

50/h

ohne Schlüssel, ohne Anmeldung

Postfach erstellen, 5/min · 50/h
Nachrichten lesen, 10/min · 50/h
Domains, 10/min

Premium · pro Konto

Jeder Premium-Tarif vervielfacht die kostenlosen Limits. Bezahlte Limits gelten pro Konto, mit dem Header X-API-Key.

Kontingent pro Konto (nicht per IP geteilt)

Limits je Tarif

Tarif	Postfach erstellen	Nachrichten lesen	Domains
Kostenlos (pro IP)	5/min · 50/h	10/min · 50/h	10/min
Monatlich ×2	10/min · 100/h	20/min · 100/h	20/min
Jährlich ×2	10/min · 100/h	20/min · 100/h	20/min
Monatlich API+ ×10	50/min · 500/h	100/min · 500/h	100/min

Premium werden um Ihre Limits zu vervielfachen.

Was Entwickler damit machen

Einige konkrete Anwendungen der mail123-API, vom E2E-Test bis zur Marketing-Automatisierung. Alle legitim, alle ohne Anmeldung.

Automatisierte E2E-Tests

Playwright, Cypress, Selenium: Generieren Sie spontan eine Adresse, füllen Sie das Formular aus, lesen Sie die Bestätigungs-E-Mail, extrahieren Sie den Link oder Code. Kompletter Zyklus in 30 Sekunden.

E-Mail-Verifizierung umgehen

Anmeldungen bei zweifelhaften Diensten, Wegwerf-Konten zum Testen einer Demo, einmaliger Zugriff auf Inhalte hinter einer E-Mail-Schranke, ohne Ihr Hauptpostfach zu verschmutzen.

Bots & Automatisierung

Scraper, die eine E-Mail-Bestätigung durchlaufen müssen, n8n/Make/Zapier-Workflows, Selenium-Skripte, die ein Onboarding automatisieren. Die API lässt sich in 3 Zeilen anbinden.

Entwicklungsumgebungen

Stage- und Preview-Umgebungen: Ersetzen Sie Mailtrap, MailHog oder SES durch eine öffentliche API. Entwickler sehen die echten E-Mails, ohne SMTP konfigurieren zu müssen.

Tutorials & Schulungen

Webhook-Demos, OAuth-Übungen, Sicherheitsschulungen: Eine öffentliche Wegwerf-Adresse ermöglicht es Lernenden, gefahrlos zu testen, ohne ihr echtes Postfach zu verwenden.

Datenschutz-Tools

Browser-Erweiterungen, Passwortmanager, Anti-Spam-Tools: Integrieren Sie die Generierung temporärer Aliasse mit einem einzigen HTTP-Aufruf.

HTTP-Codes & Fehlerbehandlung

Alle Antworten enthalten ein Feld success: bool und gegebenenfalls error: string. Die HTTP-Codes folgen den REST-Konventionen.

Code	Bedeutung	Aktion
200	Success	Antwort enthält success: true
400	Bad Request	Überprüfen Sie die Syntax der Adresse oder des Parameters
403	Forbidden	Reservierte Adresse (admin, root, postmaster…)
404	Not Found	E-Mail nicht gefunden oder abgelaufen
429	Too Many Requests	Warten Sie 1 Minute oder versuchen Sie es nach dem Reset erneut
500	Server Error	Serverfehler, versuchen Sie es erneut, andernfalls kontaktieren Sie den Support

Häufig gestellte Fragen

Antworten auf die Fragen, die uns Entwickler am häufigsten stellen.

Ist die API wirklich kostenlos?

Ja, völlig kostenlos. Keine Kreditkarte, keine Anmeldung, keine versteckten Limits. 30 Anfragen pro Stunde und IP-Adresse reichen für die meisten persönlichen Anwendungen und Tests aus. Für mehr kommt bald das Pro-Angebot.

Wird ein API-Schlüssel zur Nutzung benötigt?

Nein. Die öffentliche API funktioniert ohne Authentifizierung. Für die Pro-Version (in Kürze) wird ein X-API-Key-Schlüssel erforderlich sein, um von den höheren Limits zu profitieren.

Unterstützt die API CORS?

Ja, CORS ist vollständig offen (Access-Control-Allow-Origin: *). Sie können die API direkt aus einem Browser per JavaScript aufrufen, ohne zwischengeschalteten Proxy.

Wie lange werden die E-Mails aufbewahrt?

E-Mails werden automatisch 7 Tage nach ihrem Eingang gelöscht. Die Adresse selbst bleibt unbegrenzt nutzbar. Keine dauerhafte Speicherung der E-Mails, keine Archivierung, kein Benutzerprofil.

Erkennt die API OTP-Codes automatisch?

Ja. Jede zurückgegebene Nachricht enthält ein Feld otp_code. Unsere Extraktions-Engine erkennt numerische Codes (4 bis 8 Ziffern), alphanumerische Codes und Formate mit Trennzeichen (XX-XX, XX XX). Kontextbezogene Erkennung: Der Score steigt, wenn in der Nähe Schlüsselwörter wie "verification", "code", "OTP" vorhanden sind.

Welche E-Mail-Domains sind verfügbar?

Die derzeit aktiven Domains: mail123.frmail456.frmail789.frmail1mail.commail123.clickmail123.com.brdaftmail.cloudmail123.beermail123box.techmail123.promail123.sitemail123.onlinemail123.techmail123.website. Aktuelle Liste über GET /api/v1/domains.

Unterstützt die API Webhooks?

Noch nicht. Die aktuelle Version erfordert Polling (GET /messages alle 5-10 Sekunden). Webhooks sind für die Pro-Version geplant: HTTPS-Push-Benachrichtigung, sobald eine E-Mail in einem von Ihnen überwachten Postfach eintrifft.

Was passiert bei Überschreitung des Rate-Limits?

Die API gibt einen HTTP-Code 429 mit einem Retry-After-Header zurück, der in Sekunden die Wartezeit bis zum nächsten Versuch angibt. Die Header X-RateLimit-Remaining und X-RateLimit-Reset ermöglichen es, den Verbrauch im Voraus zu überwachen.

Welche Nutzungen sind erlaubt?

Jede legitime Nutzung: automatisierte Tests, E-Mail-Verifizierungen für Sandbox-Konten, Automatisierung von Entwickler-Workflows, Datenschutz-Tools. Missbrauch (Spam, massives Scraping, Betrug) führt ohne Vorwarnung zu einer dauerhaften IP-Sperre.

Ist der Dienst zuverlässig? Welche Verfügbarkeit?

Der Dienst läuft auf OVH-Servern in Roubaix, Frankreich, mit einer durchschnittlichen Verfügbarkeit von 99,95 % über die letzten 12 Monate. Echtzeit-Status auf status.mail123.fr.

Bauen Sie etwas Cooles

Keine Anmeldung. Keine Kreditkarte. Kein Webhook zu konfigurieren. Starten Sie Ihren ersten API-Aufruf in 10 Sekunden.

Jetzt ausprobieren Auch das Widget ansehen