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ẫn | Mô tả |
|---|---|---|
| GET | /api/domains | Danh sách tên miền khả dụng |
| POST | /api/mailbox | Tạ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/mailbox | Thông tin hộp thư hiện tại |
| DELETE | /api/mailbox | Xóa hộp thư và toàn bộ email |
| GET | /api/messages | Danh 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}/raw | Tải tệp .eml gốc |
| GET | /api/attachments/{id} | Tải tệp đính kèm |
| GET | /api/events | Luồ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": "…"}