✉ Email Tạm Thời

API mở

Tạo hộp thư tạm thời và đọc email bằng HTTP API đơn giản, lý tưởng cho kiểm thử tự động và xác minh đăng ký. Mọi endpoint đều trả về JSON.

Xác thực

Tạo hộp thư sẽ trả về một token. Gửi token này trong các yêu cầu tiếp theo:

Authorization: Bearer <token>

Giới hạn

Không có API key, mỗi IP được tạo tối đa 10 hộp thư mỗi phút. Để có giới hạn cao hơn, hãy gửi API key khi tạo:

X-API-Key: tm_xxxxxxxxxxxxxxxx

Endpoint

Phương thứcĐường dẫnMô tả
GET/api/domainsDanh sách tên miền khả dụng
POST/api/mailboxTạo hộp thư. Body rỗng để tạo địa chỉ ngẫu nhiên, hoặc {"local":"abc","domain":"…"} để tự chọn
GET/api/mailboxThông tin hộp thư hiện tại
DELETE/api/mailboxXóa hộp thư và toàn bộ email
GET/api/messagesDanh sách hộp thư đến (100 thư mới nhất)
GET/api/messages/{id}Lấy email (nội dung và tệp đính kèm)
DELETE/api/messages/{id}Xóa email
GET/api/messages/{id}/rawTải tệp .eml gốc
GET/api/attachments/{id}Tải tệp đính kèm
GET/api/eventsLuồng sự kiện SSE, gửi event: mail khi có email mới

Ví dụ

# 1. Tạo hộp thư. Body rỗng để tạo địa chỉ ngẫu nhiên, hoặc {"local":"abc","domain":"…"} để tự chọn
curl -s -X POST https://www.temp-mail.cc/api/mailbox \
  -H 'Content-Type: application/json' -d '{}'
# => {"address":"[email protected]","token":"…","expires_at":"…"}

# 2. Danh sách hộp thư đến (100 thư mới nhất)
curl -s https://www.temp-mail.cc/api/messages \
  -H 'Authorization: Bearer <token>'

# 3. Lấy email (nội dung và tệp đính kèm)
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)

Lỗi

Khi có lỗi, trả về mã trạng thái không phải 2xx kèm body JSON:

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

← Về trang chủ