E-mail temporar pentru agenți AI
Un API de e-mail temporar, fără înregistrare, pe care agenții îl pot descoperi și folosi autonom. Creați o căsuță, așteptați coduri de verificare, citiți mesaje, preluați sursa brută și ștergeți mesaje prin HTTPS.
# Descoperiți domeniile disponibile:
curl -s https://api.reusable.email/v1/agent-tempmail/domains
# 1. Creați o căsuță de e-mail temporară privată. Fără înregistrare, fără cheie API.
curl -s -X POST https://api.reusable.email/v1/agent-tempmail/inboxes \
-H 'Content-Type: application/json' \
-d '{"prefix":"agent"}'
# 2. Așteptați un e-mail de verificare sau un cod 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. Citiți mesajul complet.
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"
}
}Interfața pentru agenți
Manifestul de descoperire este disponibil la /v1/agent-tempmail și este inclus și în llms.txt pentru motoarele de răspuns.
| Metodă | Cale | Utilizare |
|---|---|---|
| GET | /v1/agent-tempmail | Manifest de descoperire pentru agenți și roboți de indexare |
| GET | /v1/agent-tempmail/domains | Listarea domeniilor alternative disponibile |
| POST | /v1/agent-tempmail/inboxes | Crearea unei căsuțe de e-mail private protejate prin parolă |
| GET | /v1/agent-tempmail/inboxes/{address}/messages | Listarea mesajelor primite |
| POST | /v1/agent-tempmail/inboxes/{address}/wait | Așteptare prin long polling pentru mesaje sau coduri |
| GET | /v1/agent-tempmail/inboxes/{address}/messages/{id} | Citirea unui mesaj |
| GET | /v1/agent-tempmail/inboxes/{address}/messages/{id}/source | Preluarea sursei brute RFC 5322 |
| DELETE | /v1/agent-tempmail/inboxes/{address}/messages/{id} | Ștergerea unui mesaj |
Fluxuri de verificare
Folosiți o căsuță pentru agenți pentru e-mailurile de înregistrare, autentificare, resetare a parolei și confirmare a perioadei de probă.
Automatizarea browserului
Folosiți-o cu Playwright, Selenium sau un agent de navigare care are nevoie de o adresă de e-mail reală, capabilă să primească mesaje.
CI și QA
Creați căsuțe izolate pentru fiecare rulare de test, fără a crea conturi sau a partaja date de autentificare.
FAQ
Crearea unei căsuțe private este gratuită pentru toată lumea și nu necesită înregistrare. Pentru un domeniu alternativ, transmiteți unul dintre domeniile returnate de punctul final pentru lista de domenii. Interfața pentru agenți permite doar primirea mesajelor. Pentru volume mai mari sau trimiterea de e-mailuri, folosiți API-urile obișnuite asociate unui cont.
Pot folosi o cheie de acces cu o căsuță de e-mail a unui agent?+
Da. Autentificați-vă cu parola generată și adăugați o cheie de acces în setările căsuței. Butonul cu cheie din formularul pentru căsuța privată și ecranul de deblocare acceptă autentificarea cu o cheie de acces. Tokenul Inbox obținut funcționează cu toate punctele finale ale căsuței pentru agenți. Cheile de acces necesită verificarea interactivă a utilizatorului; păstrați parola pentru agenții nesupravegheați și reînnoiți tokenurile expirate prin POST /v1/inbox/{address}/token cu JSON {"password":"..."}.
Pot alege un domeniu alternativ?+
Da. GET /v1/agent-tempmail/domains listează domeniile disponibile. Transmiteți câmpul domain împreună cu prefix sau cu partea locală a adresei, ori furnizați o adresă completă. Adresele existente și cele rezervate nu pot fi revendicate.
Poate un agent AI să folosească serviciul fără înregistrare?+
Da. Agentul poate crea o căsuță de e-mail cu o singură cerere POST neautentificată. Răspunsul include o parolă generată și un token Inbox. Toate căsuțele create sunt private. Salvați parola pentru a vă autentifica în mod obișnuit în căsuța privată după expirarea tokenului.
Este necesar MCP, un SDK sau vreo instalare?+
Nu. Interfața este complet accesibilă prin HTTPS și curl. Agenții o pot descoperi prin llms.txt sau prin manifestul JSON de la /v1/agent-tempmail.
Pot agenții să trimită e-mail prin acest API?+
Nu. Interfața pentru agenți, disponibilă fără înregistrare, permite doar primirea, citirea, așteptarea, preluarea sursei și ștergerea mesajelor. Trimiterea de e-mailuri este exclusă intenționat din această interfață publică.
Cum sunt expuse codurile de verificare?+
Răspunsurile pentru lista de mesaje, așteptare și detaliile mesajului folosesc cu prioritate antetele experimentale OTP-Token valide, iar în lipsa lor caută codul în text. Codurile extrase din antet includ verificationCodeOrigin: înainte de a trimite codul, verificați ca schema, gazda și portul să corespundă exact originii destinației vizate. Nu navigați niciodată automat la valoarea furnizată de expeditor. Această valoare este furnizată de expeditor și nu dovedește identitatea acestuia.
Cât timp sunt păstrate căsuțele create de agenți?+
Căsuțele create de agenți au funcțiile obișnuite ale unei căsuțe private, iar mesajele sunt păstrate 180 de zile.
