API แบบเปิด
สร้างกล่องจดหมายชั่วคราวและอ่านอีเมลด้วย HTTP API ที่ใช้งานง่าย เหมาะสำหรับการทดสอบอัตโนมัติและตรวจสอบการสมัคร ทุก endpoint ส่งกลับเป็น JSON
การยืนยันตัวตน
การสร้างกล่องจดหมายจะส่งโทเค็นกลับมา ให้ส่งโทเค็นนี้ในคำขอถัดไป:
Authorization: Bearer <token>
ขีดจำกัดการใช้งาน
หากไม่มี API key แต่ละ IP สร้างกล่องจดหมายได้สูงสุด 10 กล่องต่อนาที หากต้องการขีดจำกัดสูงขึ้น ให้ส่ง API key ขณะสร้าง:
X-API-Key: tm_xxxxxxxxxxxxxxxx
Endpoints
| เมธอด | พาธ | คำอธิบาย |
|---|---|---|
| GET | /api/domains | รายการโดเมนที่ใช้ได้ |
| POST | /api/mailbox | สร้างกล่องจดหมาย ส่ง body ว่างเพื่อสุ่มที่อยู่ หรือ {"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. สร้างกล่องจดหมาย ส่ง body ว่างเพื่อสุ่มที่อยู่ หรือ {"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 พร้อม body แบบ JSON:
{"error": "rate_limited", "message": "…"}