Posta temporanea per agenti AI
Un’API di posta temporanea senza registrazione che gli agenti possono individuare e utilizzare autonomamente. Crea una casella di posta, attendi i codici di verifica, leggi i messaggi, recupera la sorgente originale ed elimina i messaggi tramite HTTPS.
# Scopri i domini disponibili:
curl -s https://api.reusable.email/v1/agent-tempmail/domains
# 1. Crea una casella di posta temporanea privata. Nessuna registrazione, nessuna chiave API.
curl -s -X POST https://api.reusable.email/v1/agent-tempmail/inboxes \
-H 'Content-Type: application/json' \
-d '{"prefix":"agent"}'
# 2. Attendi un'e-mail di verifica o un codice OTP.
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. Leggi il messaggio completo.
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"
}
}Interfaccia per agenti
Il manifesto di individuazione è disponibile su /v1/agent-tempmail ed è sottoposto a mirroring da llms.txt per i motori di risposta.
| Metodo | Percorso | Utilizzo |
|---|---|---|
| GET | /v1/agent-tempmail | Manifesto di individuazione per agenti e crawler |
| GET | /v1/agent-tempmail/domains | Elenca i domini alternativi disponibili |
| POST | /v1/agent-tempmail/inboxes | Crea una casella di posta privata protetta da password |
| GET | /v1/agent-tempmail/inboxes/{address}/messages | Elenca i messaggi ricevuti |
| POST | /v1/agent-tempmail/inboxes/{address}/wait | Attendi email o codici tramite long polling |
| GET | /v1/agent-tempmail/inboxes/{address}/messages/{id} | Leggi un messaggio |
| GET | /v1/agent-tempmail/inboxes/{address}/messages/{id}/source | Recupera il messaggio originale in formato RFC 5322 |
| DELETE | /v1/agent-tempmail/inboxes/{address}/messages/{id} | Elimina un messaggio |
Flussi di verifica
Utilizza la casella di posta dell'agente per la registrazione, l'accesso, la reimpostazione della password e le e-mail di conferma della prova.
Automazione del browser
Abbinala a Playwright, Selenium o a un agente di navigazione che necessita di un indirizzo email reale in grado di ricevere messaggi.
CI e QA
Crea caselle di posta isolate per ogni esecuzione di test senza effettuare il provisioning di account o condividere credenziali.
Domande frequenti
La creazione di una casella di posta privata è gratuita e non richiede registrazione. Per scegliere un dominio alternativo, passa un dominio ottenuto dall’endpoint dell’elenco dei domini. L’interfaccia per agenti consente solo la ricezione. Per volumi maggiori o per inviare email, usa le normali API associate a un account.
Posso utilizzare una passkey con la casella di posta dell'agente?+
Sì. Accedi con la password generata e aggiungi una passkey nelle impostazioni della casella di posta. Il pulsante con l’icona della chiave nel modulo della casella privata e la schermata di sblocco consentono l’accesso con passkey. Il token Inbox ottenuto funziona con tutti gli endpoint della casella di posta per agenti. Le passkey richiedono la verifica interattiva dell’utente; conserva la password per gli agenti non presidiati e rinnova i token scaduti con POST /v1/inbox/{address}/token e JSON {"password":"..."}.
Posso scegliere un dominio alternativo?+
Sì. GET /v1/agent-tempmail/domains elenca i domini disponibili. Specifica domain insieme a prefix o a un address che contenga solo la parte prima della chiocciola, oppure fornisci un address completo. Gli indirizzi esistenti o riservati non possono essere registrati.
Un agente AI può utilizzarlo senza registrarsi?+
Sì. L’agente può creare una casella di posta con una richiesta POST non autenticata. La risposta include una password generata e un token Inbox. Tutte le caselle create sono private. Conserva la password per accedere normalmente alla casella privata dopo la scadenza del token.
Sono necessari MCP, un SDK o un’installazione?+
No. L’interfaccia è interamente accessibile tramite HTTPS e curl. Gli agenti possono individuarla tramite llms.txt o il manifest JSON su /v1/agent-tempmail.
Gli agenti possono inviare email tramite questa API?+
No. L’interfaccia per agenti senza registrazione consente solo di ricevere, leggere, attendere, recuperare la sorgente ed eliminare i messaggi. L’invio di email è volutamente escluso da questa interfaccia pubblica.
Come vengono forniti i codici di verifica?+
Le risposte per elenco, attesa e dettaglio dei messaggi usano preferibilmente intestazioni sperimentali OTP-Token valide; altrimenti cercano i codici nel testo. I codici ricavati dalle intestazioni includono verificationCodeOrigin: prima di inviare il codice, verifica che schema, host e porta corrispondano esattamente all’origine della destinazione prevista. Il valore è fornito dal mittente e non ne prova l’identità. Non navigare mai automaticamente verso un indirizzo fornito dal mittente.
Per quanto tempo vengono conservate le caselle di posta create dagli agenti?+
Le caselle di posta create dagli agenti hanno le normali funzionalità di posta in arrivo privata e una conservazione dei messaggi di 180 giorni.