API временной почты

Единый REST API для разработчиков: создавайте адреса temp mail, получайте настоящие письма.

Mail.td — это email-инфраструктура для разработчиков, с единым REST API для создания адресов temporary email, получения настоящих писем и доставки новых сообщений в реальном времени через WebSocket или подписанные Webhooks. API бесплатен для старта — совместим с любым HTTP-клиентом. Вызывайте его напрямую из тестов Selenium, Cypress, Playwright, Puppeteer, CI/CD-пайплайнов или собственного backend.

Рабочий процесс

Создайте почтовый ящик, получайте настоящие письма по SMTP и читайте сообщения через REST API. Ящики автоматически удаляются через 7 дней.

# 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 и клиентские библиотеки

Mail.td предоставляет официальные SDK на трёх языках. Каждый клиент полностью покрывает REST API с типизированными ответами и обработкой ошибок — установите, аутентифицируйтесь с помощью Pro API Token и начинайте пользоваться.

Node.js / TypeScript

npm install mailtd

Клиент без зависимостей, использующий нативный fetch, с полными определениями типов TypeScript.

Python

pip install mailtd

HTTP-клиент с типами dataclass и поддержкой async context manager.

Go

go get github.com/mailtd/mailtd-go

Только stdlib, жизненный цикл запросов на базе context, полностью типизированные struct.

Важные замечания Письма в Pro-плане хранятся 7 дней, затем автоматически удаляются (срок хранения в бесплатном плане смотрите на странице тарифов). Mail.td предназначен для тестирования email, QA-автоматизации и временного использования разработчиками — не как долговременный почтовый ящик.