Dočasná pošta pro agenty AI
API pro dočasné e-mailové schránky bez registrace, které mohou agenti sami objevit a používat. Vytvářejte schránky, čekejte na ověřovací kódy, čtěte zprávy, načítejte jejich původní zdroj a mažte zprávy přes HTTPS.
# Zobrazte dostupné domény:
curl -s https://api.reusable.email/v1/agent-tempmail/domains
# 1. Vytvořte soukromou dočasnou e-mailovou schránku. Žádná registrace, žádný klíč API.
curl -s -X POST https://api.reusable.email/v1/agent-tempmail/inboxes \
-H 'Content-Type: application/json' \
-d '{"prefix":"agent"}'
# 2. Počkejte na ověřovací e-mail nebo kód 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. Přečtěte si celou zprávu.
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"
}
}Rozhraní pro agenty
Manifest pro vyhledávání je dostupný na /v1/agent-tempmail a pro vyhledávače odpovědí se zrcadlí z llms.txt.
| Metoda | Cesta | Použití |
|---|---|---|
| GET | /v1/agent-tempmail | Manifest pro vyhledávání agenty a crawlery |
| GET | /v1/agent-tempmail/domains | Seznam dostupných alternativních domén |
| POST | /v1/agent-tempmail/inboxes | Vytvořit soukromou doručenou poštu chráněnou heslem |
| GET | /v1/agent-tempmail/inboxes/{address}/messages | Vypsat přijaté zprávy |
| POST | /v1/agent-tempmail/inboxes/{address}/wait | Čekat na zprávy nebo kódy pomocí long pollingu |
| GET | /v1/agent-tempmail/inboxes/{address}/messages/{id} | Přečíst zprávu |
| GET | /v1/agent-tempmail/inboxes/{address}/messages/{id}/source | Načíst původní zdroj zprávy podle RFC 5322 |
| DELETE | /v1/agent-tempmail/inboxes/{address}/messages/{id} | Smazat zprávu |
Postupy ověřování
Používejte schránku agenta pro e-maily k registraci, přihlášení, obnovení hesla a potvrzení zkušební verze.
Automatizace prohlížeče
Propojte ji s nástrojem Playwright, Selenium nebo agentem pro prohlížení webu, který potřebuje skutečnou e-mailovou adresu schopnou přijímat zprávy.
CI a QA
Pro každý běh testu vytvořte izolované schránky bez zakládání účtů a sdílení přihlašovacích údajů.
Časté dotazy
Vytvoření soukromé schránky je zdarma pro všechny a nevyžaduje registraci. Chcete-li použít jinou doménu, předejte doménu z koncového bodu se seznamem domén. Rozhraní pro agenty umožňuje pouze příjem. Pro větší objem nebo odesílání pošty používejte běžná API propojená s účtem.
Mohu použít přístupový klíč k doručené poště agenta?+
Ano. Přihlaste se vygenerovaným heslem a v nastavení schránky přidejte přístupový klíč. Tlačítko s klíčem ve formuláři soukromé schránky i na obrazovce pro odemknutí schránky umožňuje přihlášení přístupovým klíčem. Výsledný token Inbox funguje se všemi koncovými body schránky pro agenty. Přístupové klíče vyžadují interaktivní ověření uživatele; pro agenty pracující bez dozoru si ponechte heslo a vypršelé tokeny obnovte požadavkem POST /v1/inbox/{address}/token s JSON {"password":"..."}.
Mohu si vybrat alternativní doménu?+
Ano. GET /v1/agent-tempmail/domains vypíše dostupné domény. Předejte domain společně s prefix nebo s místní částí adresy, případně zadejte úplnou adresu. Již existující ani rezervované adresy nelze získat.
Může to agent umělé inteligence použít bez registrace?+
Ano. Agent může vytvořit schránku jediným neautentizovaným požadavkem POST. Odpověď obsahuje vygenerované heslo a token Inbox. Všechny vytvořené schránky jsou soukromé. Heslo si uložte pro běžné přihlášení do soukromé schránky po vypršení tokenu.
Je vyžadován MCP, SDK nebo instalace?+
Ne. Rozhraní je plně dostupné přes HTTPS a curl. Agenti ho mohou objevit pomocí llms.txt nebo manifestu JSON na /v1/agent-tempmail.
Mohou agenti posílat e-maily prostřednictvím tohoto rozhraní API?+
Ne. Rozhraní pro agenty bez registrace slouží pouze k příjmu, čtení, čekání, načtení zdrojového obsahu a mazání zpráv. Odesílání e-mailů je z tohoto veřejného rozhraní záměrně vyloučeno.
Jak jsou dostupné ověřovací kódy?+
Odpovědi se seznamem zpráv, výsledkem čekání a detailem zprávy dávají přednost platným experimentálním hlavičkám OTP-Token; pokud nejsou k dispozici, hledají kódy v textu. Kódy získané z hlavičky obsahují verificationCodeOrigin: před odesláním přesně porovnejte schéma, hostitele a port této hodnoty se zamýšleným cílem. Hodnotu dodává odesílatel a není důkazem jeho totožnosti. Nikdy automaticky nepřecházejte na adresu dodanou odesílatelem.
Jak dlouho se uchovávají schránky vytvořené agenty?+
Schránky vytvořené agenty mají běžné funkce soukromé schránky a zprávy se v nich uchovávají 180 dní.