Tijdelijke e-mail voor AI-agenten
Een tijdelijke e-mail API zonder aanmelding die agenten autonoom kunnen ontdekken en gebruiken. Maak een inbox aan, wacht op verificatiecodes, lees berichten, haal de onbewerkte bron op en verwijder berichten met gewoon HTTPS.
# Ontdek beschikbare domeinen:
curl -s https://api.reusable.email/v1/agent-tempmail/domains
# 1. Maak een privé-inbox voor tijdelijke e-mail. Geen aanmelding, geen API-sleutel.
curl -s -X POST https://api.reusable.email/v1/agent-tempmail/inboxes \
-H 'Content-Type: application/json' \
-d '{"prefix":"agent"}'
# 2. Wacht op een verificatie-e-mail of 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. Lees het volledige bericht.
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"
}
}Agentinterface
Het ontdekkingsmanifest is beschikbaar op /v1/agent-tempmail en gespiegeld vanuit llms.txt voor antwoordengines.
| Methode | Pad | Gebruik |
|---|---|---|
| GET | /v1/agent-tempmail | Discovery-manifest voor agenten en crawlers |
| GET | /v1/agent-tempmail/domains | Beschikbare alternatieve domeinen opvragen |
| POST | /v1/agent-tempmail/inboxes | Creëer een met een wachtwoord beveiligde privé-inbox |
| GET | /v1/agent-tempmail/inboxes/{address}/messages | Ontvangen berichten opvragen |
| POST | /v1/agent-tempmail/inboxes/{address}/wait | Met long polling wachten op e-mail of codes |
| GET | /v1/agent-tempmail/inboxes/{address}/messages/{id} | Lees een bericht |
| GET | /v1/agent-tempmail/inboxes/{address}/messages/{id}/source | Haal de onbewerkte RFC 5322-bron op |
| DELETE | /v1/agent-tempmail/inboxes/{address}/messages/{id} | Verwijder een bericht |
Verificatiestromen
Gebruik een agentinbox voor aanmeldings-, login-, wachtwoordreset- en proefbevestigingsmails.
Browser-automatisering
Combineer dit met Playwright, Selenium of een browseragent die een echt e-mailadres nodig heeft waarop berichten kunnen worden ontvangen.
CI en QA
Creëer geïsoleerde inboxen per testrun zonder accounts in te richten of inloggegevens te delen.
Veelgestelde vragen
Een privé-inbox maken is voor iedereen gratis en vereist geen aanmelding. Kies een alternatief domein uit het eindpunt met de domeinlijst. De agentinterface kan alleen e-mail ontvangen. Gebruik voor grotere volumes of het verzenden van e-mail de reguliere API’s die aan een account zijn gekoppeld.
Kan ik een passkey gebruiken voor een agentinbox?+
Ja. Meld u aan met het gegenereerde wachtwoord en voeg een passkey toe in de inboxinstellingen. Met de sleutelknop op het privé-inboxformulier en het ontgrendelingsscherm kunt u zich met een passkey aanmelden. Het resulterende Inbox-token werkt met alle eindpunten voor agentmailboxen. Passkeys vereisen interactieve gebruikersverificatie; bewaar het wachtwoord voor onbeheerde agents en vernieuw verlopen tokens met POST /v1/inbox/{address}/token en JSON {"password":"..."}.
Kan ik een alternatief domein kiezen?+
Ja. GET /v1/agent-tempmail/domains geeft de beschikbare domeinen weer. Geef domain mee met prefix of met een address dat alleen het deel vóór het apenstaartje bevat, of geef een volledig address op. Bestaande en gereserveerde adressen kunnen niet worden geregistreerd.
Kan een AI-agent dit gebruiken zonder zich aan te melden?+
Ja. De agent kan een inbox maken met één niet-geverifieerd POST-verzoek. Het antwoord omvat een gegenereerd wachtwoord en een Inbox-token. Alle aangemaakte inboxen zijn privé. Bewaar het wachtwoord voor normale aanmelding bij de privé-inbox nadat het token is verlopen.
Is MCP, een SDK of installatie vereist?+
Nee. De interface is volledig bereikbaar via HTTPS en curl. Agenten kunnen het ontdekken via llms.txt of het JSON-manifest op /v1/agent-tempmail.
Kunnen agenten e-mail verzenden via deze API?+
Nee. Via de agentinterface zonder aanmelding kunt u alleen berichten ontvangen, lezen, erop wachten, de bron ophalen en berichten verwijderen. Uitgaande e-mail is bewust uitgesloten van deze openbare interface.
Hoe worden verificatiecodes beschikbaar gesteld?+
De antwoorden voor de berichtenlijst, wachten en berichtdetails geven voorrang aan geldige experimentele OTP-Token-headers en zoeken anders naar codes in de tekst. Bij codes uit headers hoort verificationCodeOrigin: controleer vóór het verzenden van de code of het schema, de host en de poort exact overeenkomen met de oorsprong van de beoogde bestemming. De afzender levert deze waarde aan; die bewijst de identiteit van de afzender niet. Navigeer nooit automatisch naar een adres dat door de afzender is opgegeven.
Hoe lang worden door agenten gemaakte inboxen bewaard?+
Door agenten gemaakte inboxen hebben de normale mogelijkheden voor privé-inboxen en kunnen berichten 180 dagen bewaren.
