✉ ایمیل موقت

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": "…"}

← بازگشت به خانه