REST API · v1 · Kostenlos

Temporäre E-Mail,
curl-ready.

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
11 Domains
7j Aufbewahrung
0€ Kosten
Jetzt ausprobieren Dokumentation
01 / Playground

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.

Request
GET https://mail123.fr/api/v1/mailbox/new
Response
Klicken Sie auf Execute, um die Anfrage zu starten…
Request
GET https://mail123.fr/api/v1/mailbox/{address}/messages
Response
Klicken Sie auf Execute, um die Anfrage zu starten…
Request
GET https://mail123.fr/api/v1/mailbox/{address}/messages/{id}
Response
Klicken Sie auf Execute, um die Anfrage zu starten…
Request
GET https://mail123.fr/api/v1/domains

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

Response
Klicken Sie auf Execute, um die Anfrage zu starten…
02 / Endpoints

4 Endpoints, 0 Magie

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
03 / Snippets

Copy-paste in Ihren Stack

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

# 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 / Kontingente

Heute kostenlos, Pro bald

Die kostenlose öffentliche API deckt die meisten persönlichen Anwendungen und Tests ab. Für größere Mengen oder kommerzielle Nutzung kommt bald ein Pro-Angebot.

Kostenlos
50 req/h
5 pro Minute, par IP
  • Ohne API-Schlüssel
  • Offenes CORS
  • Automatische OTP-Erkennung
  • 4 verfügbare Domains
  • Sauberes UTF-8-JSON
Pro · Bald
5 000 req/h
API-Schlüssel, Support, SLA
  • 150x höheres Volumen
  • Webhooks bei E-Mail-Eingang
  • Eigene Domain
  • 30 Tage Aufbewahrung
  • Priorisierter Support
05 / Anwendungsfälle

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.

06 / Errors

HTTP-Codes & Fehlerbehandlung

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

CodeBedeutungAktion
200SuccessAntwort enthält success: true
400Bad RequestÜberprüfen Sie die Syntax der Adresse oder des Parameters
403ForbiddenReservierte Adresse (admin, root, postmaster…)
404Not FoundE-Mail nicht gefunden oder abgelaufen
429Too Many RequestsWarten Sie 1 Minute oder versuchen Sie es nach dem Reset erneut
500Server ErrorServerfehler — versuchen Sie es erneut, andernfalls kontaktieren Sie den Support
07 / FAQ

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?
Die Postfächer und ihre E-Mails werden automatisch gelöscht nach 7 Tagen Inaktivität. Keine dauerhafte Speicherung, 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.frmail123.cloudmail1mail.commail123.clickmaildaft.commail123.com.brdaftmail.cloudmailtemp.frmail123.beer. 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