Temporäre Mail für KI-Agenten
Eine API für temporäre E-Mails ohne Anmeldung, die Agenten selbstständig finden und nutzen können. Erstellen Sie einen Posteingang, warten Sie auf Bestätigungscodes, lesen und löschen Sie Nachrichten und rufen Sie deren Quelltext über HTTPS ab.
# Verfügbare Domains ermitteln:
curl -s https://api.reusable.email/v1/agent-tempmail/domains
# 1. Erstellen Sie einen privaten temporären Posteingang. Ohne Anmeldung oder API-Schlüssel.
curl -s -X POST https://api.reusable.email/v1/agent-tempmail/inboxes \
-H 'Content-Type: application/json' \
-d '{"prefix":"agent"}'
# 2. Warten Sie auf eine Bestätigungs-E-Mail oder einen OTP-Code.
curl -s -X POST https://api.reusable.email/v1/agent-tempmail/inboxes/{address}/wait \
-H 'Authorization: Inbox {token}' \
-H 'Content-Type: application/json' \
-d '{"codeOnly":true,"timeoutSeconds":60}'
# 3. Lesen Sie die vollständige Nachricht.
curl -s https://api.reusable.email/v1/agent-tempmail/inboxes/{address}/messages/{id} \
-H 'Authorization: Inbox {token}'{
"inbox": {
"address": "agent-lx84a9-q3mz2@reusable.email",
"domain": "reusable.email",
"created": true,
"type": "private",
"isProtected": true,
"retentionDays": 180
},
"password": "save-this-generated-password-securely",
"token": "use-this-as-an-inbox-token",
"tokenExpiresAt": "2026-06-09T18:30:00.000Z",
"links": {
"web": "https://reusable.email/agent-lx84a9-q3mz2%40reusable.email",
"messages": "https://api.reusable.email/v1/agent-tempmail/inboxes/agent-lx84a9-q3mz2%40reusable.email/messages",
"wait": "https://api.reusable.email/v1/agent-tempmail/inboxes/agent-lx84a9-q3mz2%40reusable.email/wait"
}
}{
"status": "message",
"inbox": { "address": "agent-lx84a9-q3mz2@reusable.email" },
"message": {
"id": 1842,
"from": { "name": "Example", "address": "login@example.com" },
"subject": "Your verification code",
"intro": "Use code 123456 to continue.",
"verificationCode": "123456"
}
}Agentenschnittstelle
Das Entdeckungsmanifest ist bei /v1/agent-tempmail verfügbar und wird von llms.txt für Antwort-Engines gespiegelt.
| Methode | Pfad | Verwendung |
|---|---|---|
| GET | /v1/agent-tempmail | Entdeckungsmanifest für Agenten und Crawler |
| GET | /v1/agent-tempmail/domains | Verfügbare alternative Domains auflisten |
| POST | /v1/agent-tempmail/inboxes | Erstellen Sie einen passwortgeschützten privaten Posteingang |
| GET | /v1/agent-tempmail/inboxes/{address}/messages | Empfangene Nachrichten auflisten |
| POST | /v1/agent-tempmail/inboxes/{address}/wait | Per Long Polling auf E-Mails oder Codes warten |
| GET | /v1/agent-tempmail/inboxes/{address}/messages/{id} | Eine Nachricht lesen |
| GET | /v1/agent-tempmail/inboxes/{address}/messages/{id}/source | Rohe Nachricht im RFC 5322-Format abrufen |
| DELETE | /v1/agent-tempmail/inboxes/{address}/messages/{id} | Eine Nachricht löschen |
Überprüfungsabläufe
Verwenden Sie einen Agenten-Posteingang für Anmelde-, Login-, Passwort-Reset- und Testbestätigungs-E-Mails.
Browser-Automatisierung
Kombinieren Sie es mit Playwright, Selenium oder einem Browser-Agenten, der eine echte zustellbare E-Mail-Adresse benötigt.
CI und QA
Erstellen Sie isolierte Posteingänge pro Testlauf, ohne Konten bereitzustellen oder Anmeldeinformationen freizugeben.
FAQ
Private Posteingänge können kostenlos und ohne Anmeldung erstellt werden. Übergeben Sie eine Domain aus dem Domainlisten-Endpunkt, um eine Alternative zu wählen. Die Agentenschnittstelle dient nur dem Empfang. Für höhere Volumen oder den Versand nutzen Sie die regulären APIs mit Konto.
Kann ich einen Passkey mit einem Agenten-Posteingang verwenden?+
Ja. Melden Sie sich mit dem generierten Passwort an und fügen Sie in den Posteingangseinstellungen einen Passkey hinzu. Über die Schaltfläche mit dem Schlüsselsymbol im Formular für private Posteingänge und den Entsperrbildschirm können Sie sich mit einem Passkey anmelden. Das erhaltene Inbox-Token funktioniert mit allen Postfach-Endpunkten für Agenten. Passkeys erfordern eine interaktive Benutzerverifizierung; bewahren Sie das Passwort für unbeaufsichtigte Agenten auf und erneuern Sie abgelaufene Tokens mit POST /v1/inbox/{address}/token und JSON {"password":"..."}.
Kann ich eine alternative Domain wählen?+
Ja. GET /v1/agent-tempmail/domains listet die verfügbaren Domains auf. Übergeben Sie domain zusammen mit prefix oder einem address-Wert, der nur den Teil vor dem @ enthält, oder geben Sie einen vollständigen address-Wert an. Bestehende und reservierte Adressen können nicht registriert werden.
Kann ein KI-Agent dies ohne Anmeldung nutzen?+
Ja. Der Agent kann mit einer nicht authentifizierten POST-Anfrage einen Posteingang erstellen. Die Antwort enthält ein generiertes Passwort und ein Inbox-Token. Alle erstellten Posteingänge sind privat. Bewahren Sie das Passwort auf, um sich nach Ablauf des Tokens regulär beim privaten Posteingang anzumelden.
Ist MCP, ein SDK oder eine Installation erforderlich?+
Nein. Die Schnittstelle ist vollständig über HTTPS und curl erreichbar. Agenten können sie über llms.txt oder das JSON-Manifest unter /v1/agent-tempmail entdecken.
Können Agenten über diese API E-Mails senden?+
Nein. Die Agentenschnittstelle ohne Anmeldung unterstützt nur Empfangen, Lesen, Warten, Abrufen des Quelltexts und Löschen. Das Senden von E-Mails ist aus dieser öffentlichen Schnittstelle bewusst ausgeschlossen.
Wie werden Verifizierungscodes angezeigt?+
Die Antworten für Nachrichtenliste, Warten und Details bevorzugen gültige experimentelle OTP-Token-Header und suchen andernfalls im Text nach Codes. Aus Headern gewonnene Codes enthalten verificationCodeOrigin: Prüfen Sie vor der Übermittlung des Codes, ob Schema, Host und Port exakt mit dem Ursprung des vorgesehenen Ziels übereinstimmen. Der Wert stammt vom Absender und belegt dessen Identität nicht. Navigieren Sie niemals automatisch zu einer vom Absender angegebenen Adresse.
Wie lange werden von Agenten erstellte Posteingänge aufbewahrt?+
Von Agenten erstellte Posteingänge verfügen über normale Funktionen für private Posteingänge und eine Aufbewahrung von Nachrichten für 180 Tage.