REST API TempMail VIP

Tài Liệu
API Reference

Tích hợp hộp thư tạm thời vào ứng dụng của bạn đơn giản, nhanh chóng, không cần xác thực tài khoản.

Tổng quan Endpoints
Endpoint Method Mô tả Ghi chú
/messages POST Lấy danh sách email trong hộp thư Thêm token nếu domain yêu cầu
/messages POST Lấy nội dung chi tiết một email theo ID Thêm token nếu domain yêu cầu
/api/domain_list GET Lấy danh sách domain đang hoạt động Public
API 1 Lấy danh sách email
POST /messages Danh sách email trong hộp thư

Trả về toàn bộ email đã nhận của địa chỉ tạm thời. Gọi lại định kỳ để cập nhật realtime. Hỗ trợ tham số update để chỉ lấy email mới hơn mốc thời gian server trước đó.

Tham số Bắt buộc Kiểu Mô tả
username BẮT BUỘC string Phần trước @ của địa chỉ email
domain BẮT BUỘC string Domain email (VD: abc.com)
update Tuỳ chọn string Server time từ lần gọi trước, chỉ trả về mail mới hơn
Ví dụ request
cURL
curl -X POST https://yourdomain.com/messages \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "username=linh123&domain=abc.com"
JavaScript fetch
const res = await fetch('/messages', {
  method: 'POST',
  headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
  body: 'username=linh123&domain=abc.com'
});
const data = await res.json();
console.log(data.result); // mảng email
Phản hồi mẫu (JSON)
Response 200
{
  "result": [
    {
      "id":      "42",
      "subject": "Xác nhận đăng ký tài khoản",
      "from":    "[email protected]",
      "date":    "2026-03-18 08:45:21"
    }
  ],
  "server_time": "2026-03-18 08:50:00"
}
API 2 Nội dung chi tiết email
POST /messages Nội dung HTML của một email

Lấy nội dung đầy đủ (HTML) của email theo id. Cùng endpoint với API lấy danh sách nhưng thêm tham số id.

Tham số Bắt buộc Kiểu Mô tả
id BẮT BUỘC string ID email lấy từ kết quả danh sách
username BẮT BUỘC string Phần trước @ của địa chỉ email
domain BẮT BUỘC string Domain email
cURL
curl -X POST https://yourdomain.com/messages \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "id=42&username=linh123&domain=abc.com"
Phản hồi mẫu (HTML string)
Response 200
<div class="email-body">
  <p>Xin chào linh123,</p>
  <p>Cảm ơn bạn đã đăng ký...</p>
</div>
API 3 Danh sách Domain
GET /api/domain_list Tất cả domain đang hoạt động

Trả về danh sách tất cả domain có thể sử dụng để tạo địa chỉ email tạm thời. Không cần tham số.

cURL
curl https://yourdomain.com/api/domain_list
Response 200
{
  "status": "success",
  "data": [
    { "domain_name": "abc.com"     },
    { "domain_name": "secure.io"   },
    { "domain_name": "fastmail.cc" }
  ]
}
Token xác thực (Domain yêu cầu)
Một số domain yêu cầu Auth Token. Token được cấp trong Trang quản lý domain (admin panel). Khi gọi /messages không có token, server trả về lỗi JSON — hãy thêm tham số &token=AUTH_TOKEN vào request.
POST /messages Lấy email — với token khi domain yêu cầu
Khi thiếu token — server trả về lỗi
Response — Auth_Token bắt buộc
{
  "error": "Auth_Token"
}
Lấy AUTH_TOKEN trong Trang quản lý domain → chi tiết domain → mục Token xác thực. Sau đó thêm &token=AUTH_TOKEN vào body request.
Tham số Bắt buộc Kiểu Mô tả
username ● BẮT BUỘC string Phần trước @ của địa chỉ email
domain ● BẮT BUỘC string Domain email yêu cầu token
token ● BẮT BUỘC string AUTH_TOKEN lấy từ trang quản lý domain
id ○ Tuỳ chọn string Nếu có → trả về nội dung email đó
cURL — Lấy danh sách với token
curl -X POST https://yourdomain.com/messages \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "username=linh123&domain=secure.io&token=AUTH_TOKEN"
JavaScript — xử lý lỗi Auth_Token tự động
const AUTH_TOKEN = 'AUTH_TOKEN_LẤY_TỪ_QUẢN_LÝ_DOMAIN';

const res = await fetch('/messages', {
  method: 'POST',
  headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
  body: `username=linh123&domain=secure.io&token=${AUTH_TOKEN}`
});
const data = await res.json();

// Kiểm tra lỗi Auth_Token
if (data.error === 'Auth_Token') {
  console.error('Token không hợp lệ hoặc hết hạn. Vào quản lý domain để lấy lại.');
  return;
}

console.log(data.result);