✉ بريد مؤقت

واجهة API مفتوحة

أنشئ صناديق مؤقتة واقرأ الرسائل عبر واجهة HTTP بسيطة، مثالية للاختبارات الآلية والتحقق من التسجيل. جميع النقاط تُعيد JSON.

المصادقة

يُعيد إنشاء الصندوق رمزًا (token). أرسله في الطلبات التالية:

Authorization: Bearer <token>

حدود الاستخدام

بدون مفتاح API يمكن لكل عنوان IP إنشاء 10 صناديق كحد أقصى في الدقيقة. لحدود أعلى أرسل مفتاح API عند الإنشاء:

X-API-Key: tm_xxxxxxxxxxxxxxxx

نقاط النهاية

الطريقةالمسارالوصف
GET/api/domainsقائمة النطاقات المتاحة
POST/api/mailboxإنشاء صندوق. جسم فارغ لعنوان عشوائي، أو {"local":"abc","domain":"…"} لعنوان مخصص
GET/api/mailboxمعلومات الصندوق الحالي
DELETE/api/mailboxحذف الصندوق وجميع رسائله
GET/api/messagesقائمة الوارد (آخر 100)
GET/api/messages/{id}جلب رسالة (المحتوى والمرفقات)
DELETE/api/messages/{id}حذف رسالة
GET/api/messages/{id}/rawتنزيل ملف ‎.eml الأصلي
GET/api/attachments/{id}تنزيل مرفق
GET/api/eventsبث أحداث SSE، يرسل event: mail عند وصول رسائل جديدة

أمثلة

# 1. إنشاء صندوق. جسم فارغ لعنوان عشوائي، أو {"local":"abc","domain":"…"} لعنوان مخصص
curl -s -X POST https://www.temp-mail.cc/api/mailbox \
  -H 'Content-Type: application/json' -d '{}'
# => {"address":"[email protected]","token":"…","expires_at":"…"}

# 2. قائمة الوارد (آخر 100)
curl -s https://www.temp-mail.cc/api/messages \
  -H 'Authorization: Bearer <token>'

# 3. جلب رسالة (المحتوى والمرفقات)
curl -s https://www.temp-mail.cc/api/messages/123 \
  -H 'Authorization: Bearer <token>'
# Python
import requests, time
base = "https://www.temp-mail.cc"
mb = requests.post(f"{base}/api/mailbox", json={}).json()
headers = {"Authorization": f"Bearer {mb['token']}"}
print(mb["address"])
while True:
    msgs = requests.get(f"{base}/api/messages", headers=headers).json()["messages"]
    if msgs:
        print(requests.get(f"{base}/api/messages/{msgs[0]['id']}", headers=headers).json()["text"])
        break
    time.sleep(3)

الأخطاء

عند حدوث خطأ تُعاد حالة غير 2xx مع جسم JSON:

{"error": "rate_limited", "message": "…"}

← العودة إلى الرئيسية