واجهة 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": "…"}