عارضی ای میل API

ڈویلپرز کے لیے یونیفائیڈ REST API: temp mail ایڈریس بنائیں، حقیقی ای میلز وصول کریں۔

Mail.td ڈویلپرز کے لیے ای میل انفراسٹرکچر ہے، جس میں temporary email ایڈریس بنانے، حقیقی ای میلز وصول کرنے اور WebSocket یا signed Webhook کے ذریعے نئے پیغامات ریئل ٹائم میں پہنچانے کے لیے ایک یونیفائیڈ REST API ہے۔ API شروع کرنے کے لیے مفت ہے — کسی بھی HTTP client کے ساتھ مطابقت پذیر۔ اسے Selenium، Cypress، Playwright، Puppeteer ٹیسٹس، CI/CD pipeline، یا اپنے 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 اور Client لائبریریاں

Mail.td تین زبانوں میں آفیشل SDKs فراہم کرتا ہے۔ ہر client typed responses اور error handling کے ساتھ REST API کو مکمل طور پر کور کرتا ہے — انسٹال کریں، اپنے Pro API Token سے توثیق کریں، اور استعمال شروع کریں۔

Node.js / TypeScript

npm install mailtd

Native fetch استعمال کرنے والا zero-dependency client، مکمل TypeScript type definitions کے ساتھ۔

Python

pip install mailtd

HTTP پر مبنی client، dataclass types اور async context manager سپورٹ کے ساتھ۔

Go

go get github.com/mailtd/mailtd-go

صرف stdlib، context پر مبنی request lifecycle، مکمل typed struct کے ساتھ۔

اہم نوٹس Pro پلان کی ای میلز 7 دن تک رکھی جاتی ہیں، پھر خودکار طور پر حذف کر دی جاتی ہیں (مفت پلان کی برقراری کے لیے قیمت کا صفحہ دیکھیں)۔ Mail.td ای میل ٹیسٹنگ، QA آٹومیشن اور ڈویلپرز کے عارضی استعمال کے لیے ڈیزائن کیا گیا ہے — طویل مدتی mailbox کے طور پر نہیں۔