API باز
با یک API ساده HTTP صندوق موقت بسازید و ایمیلها را بخوانید؛ مناسب برای تست خودکار و بررسی ثبتنام. همه نقاط پایانی JSON برمیگردانند.
احراز هویت
ساخت صندوق یک توکن برمیگرداند. آن را در درخواستهای بعدی بفرستید:
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 | فهرست صندوق ورودی (۱۰۰ مورد آخر) |
| 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. فهرست صندوق ورودی (۱۰۰ مورد آخر)
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": "…"}