Hướng dẫn API TempMail

Tài liệu tiếng Việt cho các URL gọi API: tạo email, xem inbox và đọc nội dung thư.

Base URL

https://tempmailapi.io.vn
https://tempmailvip.online

Xác thực

Lấy API key sau khi đăng nhập, bấm nút API và tạo key.

Header: X-API-Key: YOUR_API_KEY
Query:  ?api_key=YOUR_API_KEY

Không chia sẻ API key thật trong ảnh chụp hoặc log.

Giới hạn request

Không còn giới hạn theo ngày. API chỉ giới hạn theo phút và giờ cho user thường. Admin không bị giới hạn.

Khoảng thời gian	Giới hạn
Mỗi phút	300 request
Mỗi giờ	10,000 request

X-API-Usage-Minute: current/300
X-API-Usage-Hour: current/10000

GETDanh sách domain

Không cần API key.

curl "https://tempmailapi.io.vn/public_api.php?action=domains"

{"success":true,"domains":["tempmailapi.io.vn","apponi.site"]}

GETTạo email

Tham số	Bắt buộc	Mô tả
api_key	Có	API key của bạn
user	Không	Tên trước @, bỏ trống sẽ random
domain	Không	Domain muốn tạo email

curl -X GET "https://tempmailapi.io.vn/public_api.php?action=create&api_key=YOUR_API_KEY&user=mytest&domain=apponi.site" \
  -H "X-API-Key: YOUR_API_KEY"

{"success":true,"email":"mytest@apponi.site","password":"STRONG_PASSWORD"}

GETLấy danh sách thư

Tham số	Bắt buộc	Mô tả
api_key	Có	API key của bạn
email	Có	Địa chỉ email đầy đủ
limit	Không	Số thư tối đa, tối đa 50

curl "https://tempmailapi.io.vn/public_api.php?action=list&api_key=YOUR_API_KEY&email=mytest@apponi.site&limit=20" \
  -H "X-API-Key: YOUR_API_KEY"

{"success":true,"emails":[{"id":1,"uid":42,"position":1,"from":"sender@example.com","subject":"OTP"}],"total":1}

GETĐọc nội dung thư

Tham số	Bắt buộc	Mô tả
api_key	Có	API key của bạn
email	Có	Địa chỉ email đầy đủ
id	Không	ID từ list hoặc thứ tự 1-based
uid	Không	UID ổn định của mail
email_id	Không	Alias của id cho client cũ

curl "https://tempmailapi.io.vn/public_api.php?action=read&api_key=YOUR_API_KEY&email=mytest@apponi.site&uid=42" \
  -H "X-API-Key: YOUR_API_KEY"

{"success":true,"email":{"id":1,"uid":42,"position":1,"subject":"OTP","body_text":"...","body_html":"..."}}

Mã lỗi thường gặp

Code	Ý nghĩa
200	Thành công
400	Tham số sai hoặc domain không được phép
401	Thiếu hoặc sai API key
429	Quá giới hạn request
500	Lỗi server