واجهة API للبريد المؤقت

Mail.td هي بنية تحتية للبريد الإلكتروني للمطورين، تقدّم واجهة REST API موحّدة لإنشاء عناوين temporary email، واستقبال رسائل حقيقية، وتسليم الرسائل الجديدة في الوقت الفعلي عبر WebSocket أو Webhook موقّعة. الـAPI مجانية للبدء — متوافقة مع أي HTTP client. استدعها مباشرة من اختبارات Selenium وCypress وPlaywright وPuppeteer، أو pipelines الـ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 ومكتبات Client

يوفر Mail.td حزم SDK رسمية بثلاث لغات. يغطي كل client الـREST API بالكامل مع استجابات مُتَحَدَّدة الأنواع ومعالجة للأخطاء — ثبّت، صادق بـPro API Token، وابدأ الاستخدام.