Tymczasowa poczta dla agentów AI
API tymczasowej poczty bez rejestracji, które agenci mogą znajdować i wykorzystywać samodzielnie. Twórz skrzynki, czekaj na kody weryfikacyjne, czytaj i usuwaj wiadomości oraz pobieraj ich surowe źródło przez HTTPS.
# Odkryj dostępne domeny:
curl -s https://api.reusable.email/v1/agent-tempmail/domains
# 1. Utwórz prywatną tymczasową skrzynkę odbiorczą. Bez rejestracji, bez klucza API.
curl -s -X POST https://api.reusable.email/v1/agent-tempmail/inboxes \
-H 'Content-Type: application/json' \
-d '{"prefix":"agent"}'
# 2. Poczekaj na e-mail weryfikacyjny lub kod 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. Przeczytaj całą wiadomość.
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"
}
}Interfejs agenta
Manifest wykrywania jest dostępny pod adresem /v1/agent-tempmail i powielony w llms.txt dla systemów odpowiadających na pytania.
| Metoda | Ścieżka | Zastosowanie |
|---|---|---|
| GET | /v1/agent-tempmail | Manifest wykrywania dla agentów i robotów indeksujących |
| GET | /v1/agent-tempmail/domains | Lista dostępnych alternatywnych domen |
| POST | /v1/agent-tempmail/inboxes | Utwórz prywatną skrzynkę odbiorczą zabezpieczoną hasłem |
| GET | /v1/agent-tempmail/inboxes/{address}/messages | Lista odebranych wiadomości |
| POST | /v1/agent-tempmail/inboxes/{address}/wait | Długie oczekiwanie na wiadomości lub kody (long polling) |
| GET | /v1/agent-tempmail/inboxes/{address}/messages/{id} | Przeczytaj wiadomość |
| GET | /v1/agent-tempmail/inboxes/{address}/messages/{id}/source | Pobierz surowe źródło RFC 5322 |
| DELETE | /v1/agent-tempmail/inboxes/{address}/messages/{id} | Usuń wiadomość |
Przepływy weryfikacji
Użyj skrzynki odbiorczej agenta do rejestracji, logowania, resetowania hasła i e-maili z potwierdzeniem wersji próbnej.
Automatyzacja przeglądarki
Użyj go z Playwright, Selenium lub agentem przeglądarkowym, który potrzebuje prawdziwego adresu do odbierania wiadomości.
CI i QA
Twórz oddzielne skrzynki dla każdego uruchomienia testów bez zakładania kont ani udostępniania danych dostępowych.
Często zadawane pytania
Utworzenie prywatnej skrzynki jest bezpłatne i nie wymaga rejestracji. Aby wybrać inną domenę, przekaż domenę z listy dostępnej przez API. Interfejs agenta służy wyłącznie do odbierania wiadomości. Do większego ruchu lub wysyłania poczty użyj zwykłych interfejsów API powiązanych z kontem.
Czy mogę używać klucza dostępu do skrzynki agenta?+
Tak. Zaloguj się wygenerowanym hasłem i dodaj klucz dostępu w ustawieniach skrzynki. Przycisk klucza na formularzu prywatnej skrzynki i na ekranie jej odblokowania umożliwia logowanie kluczem dostępu. Uzyskany token Inbox działa ze wszystkimi punktami końcowymi skrzynki agenta. Klucze dostępu wymagają interaktywnej weryfikacji użytkownika; zachowaj hasło dla agentów działających bez nadzoru i odnawiaj wygasłe tokeny za pomocą POST /v1/inbox/{address}/token oraz JSON {"password":"..."}.
Czy mogę wybrać alternatywną domenę?+
Tak. GET /v1/agent-tempmail/domains zwraca listę dostępnych domen. Przekaż domain wraz z prefix lub lokalną częścią adresu albo podaj pełny adres. Zajętych i zastrzeżonych adresów nie można przejąć.
Czy agent AI może z tego korzystać bez rejestracji?+
Tak. Agent może utworzyć skrzynkę jednym nieuwierzytelnionym żądaniem POST. Odpowiedź zawiera wygenerowane hasło i token Inbox. Wszystkie utworzone skrzynki są prywatne. Zachowaj hasło, aby zalogować się do prywatnej skrzynki po wygaśnięciu tokenu.
Czy wymagane są MCP, SDK lub instalacja?+
Nie. Interfejs jest w pełni dostępny poprzez HTTPS i curl. Agenci mogą to odkryć poprzez llms.txt lub manifest JSON w /v1/agent-tempmail.
Czy agenci mogą wysyłać wiadomości e-mail za pośrednictwem tego API?+
Nie. Interfejs agenta bez rejestracji umożliwia tylko odbieranie, odczytywanie, oczekiwanie, pobieranie źródła i usuwanie wiadomości. Wysyłanie poczty jest celowo wyłączone z tego publicznego interfejsu.
Jak udostępniane są kody weryfikacyjne?+
Odpowiedzi zawierające listę wiadomości, wynik oczekiwania lub szczegóły wiadomości najpierw korzystają z prawidłowych eksperymentalnych nagłówków OTP-Token; jeśli ich brak lub są nieprawidłowe, kod jest wyszukiwany w tekście. Kodom z nagłówka towarzyszy pole verificationCodeOrigin: przed wpisaniem kodu porównaj je dokładnie z docelowym origin (schematem, domeną i portem). Wartość tę podaje nadawca; nie stanowi ona dowodu jego tożsamości. Nigdy nie przechodź automatycznie pod ten adres.
Jak długo przechowywane są skrzynki odbiorcze utworzone przez agenta?+
Skrzynki utworzone przez agenta mają standardowe funkcje prywatnej skrzynki, a wiadomości są przechowywane przez 180 dni.