API Tymczasowego E-maila

Zunifikowane REST API dla deweloperów: twórz adresy temp mail, odbieraj prawdziwe e-maile.

Mail.td to infrastruktura e-mail dla deweloperów — zunifikowane REST API do tworzenia adresów temporary email, odbierania prawdziwych e-maili i dostarczania nowych wiadomości w czasie rzeczywistym przez WebSocket lub podpisane Webhooki. API jest darmowe na start — kompatybilne z dowolnym klientem HTTP. Wywołuj je bezpośrednio z testów Selenium, Cypress, Playwright, Puppeteer, pipeline'ów CI/CD lub własnego backendu.

Przepływ pracy

Utwórz skrzynkę, odbieraj prawdziwe wiadomości przez SMTP i czytaj je przez REST API. Skrzynki wygasają automatycznie po 7 dniach.

# 1. Create a mailbox
$ curl -X POST https://api.mail.td/api/accounts \
    -H "Authorization: Bearer td_xxx" \
    -d '{"address":"user@mail.td","password":"secret"}'
→ { "id": "a1b2c3d4-...", "address": "user@mail.td" }

# 2. List incoming messages
$ curl https://api.mail.td/api/accounts/a1b2c3d4-.../messages \
    -H "Authorization: Bearer td_xxx"
→ { "messages": [ { "id": "f5e6d7c8-...", "from": "...", "subject": "...", "created_at": "..." } ] }

# 3. Read a message
$ curl https://api.mail.td/api/accounts/a1b2c3d4-.../messages/f5e6d7c8-... \
    -H "Authorization: Bearer td_xxx"
→ { "from": "...", "subject": "...", "text_body": "...", "html_body": "...", "attachments": [...] }

SDK i biblioteki klienckie

Mail.td dostarcza oficjalne SDK w trzech językach. Każdy klient w pełni pokrywa REST API typowanymi odpowiedziami i obsługą błędów — zainstaluj, uwierzytelnij się swoim Pro API Token i zacznij używać.

Node.js / TypeScript

npm install mailtd

Bezzależnościowy klient używający natywnego fetch, z pełnymi definicjami typów TypeScript.

Python

pip install mailtd

Klient oparty na HTTP z typami dataclass i obsługą async context manager.

Go

go get github.com/mailtd/mailtd-go

Tylko stdlib, cykl życia żądania oparty na context, w pełni typowane struct.

Ważne uwagi E-maile w planie Pro są przechowywane przez 7 dni, a następnie automatycznie usuwane (czas przechowywania w planie darmowym znajdziesz na stronie cennika). Mail.td jest zaprojektowany do testów e-maili, automatyzacji QA i tymczasowego użytku dla deweloperów — nie jako długoterminowa skrzynka pocztowa.