API ایمیل موقت

REST API یکپارچه برای توسعه‌دهندگان: آدرس‌های temp mail بسازید، ایمیل‌های واقعی دریافت کنید.

Mail.td زیرساخت ایمیل برای توسعه‌دهندگان است، با یک REST API یکپارچه برای ساخت آدرس‌های temporary email، دریافت ایمیل‌های واقعی و تحویل پیام‌های جدید به صورت بلادرنگ از طریق WebSocket یا Webhook‌های امضاشده. API برای شروع رایگان است — سازگار با هر HTTP client. آن را مستقیماً از تست‌های Selenium، Cypress، Playwright، Puppeteer، pipeline‌های CI/CD یا backend خودتان فراخوانی کنید.

گردش کار

یک صندوق پستی ایجاد کنید، ایمیل‌های واقعی را از طریق SMTP دریافت کنید و پیام‌ها را از طریق REST API بخوانید. صندوق‌های پستی پس از ۷ روز به‌طور خودکار منقضی می‌شوند.

# 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 و کتابخانه‌های Client

Mail.td در سه زبان SDK رسمی ارائه می‌دهد. هر client REST API را با پاسخ‌های تایپ‌شده و مدیریت خطا به طور کامل پوشش می‌دهد — نصب کنید، با Pro API Token احراز هویت کنید و شروع به استفاده کنید.

Node.js / TypeScript

npm install mailtd

Client بدون وابستگی با استفاده از fetch نیتیو، همراه با تعاریف تایپ کامل TypeScript.

Python

pip install mailtd

Client مبتنی بر HTTP با تایپ‌های dataclass و پشتیبانی از async context manager.

Go

go get github.com/mailtd/mailtd-go

تنها با stdlib، چرخه حیات درخواست مبتنی بر context، struct‌های کاملاً تایپ‌شده.

نکات مهم ایمیل‌های پلن Pro به مدت ۷ روز نگه‌داری می‌شوند، سپس به صورت خودکار حذف می‌شوند (برای مدت نگه‌داری پلن رایگان به صفحه قیمت‌گذاری مراجعه کنید). Mail.td برای تست ایمیل، اتوماسیون QA و استفاده موقت توسعه‌دهندگان طراحی شده است — نه به عنوان mailbox بلندمدت.