Tích hợp dịch vụ email tạm thời vào ứng dụng của bạn chỉ với vài dòng mã. Công cụ mạnh mẽ cho automation, testing và privacy.
Chào mừng bạn đến với tài liệu hướng dẫn tích hợp **EZMinBOX API**. Hệ thống của chúng tôi cung cấp giải pháp email tạm thời (disposable email) tốc độ cao, bảo mật và dễ sử dụng thông qua giao thức REST API chuẩn.
Tin nhắn được nhận và hiển thị trong chưa đầy 1 giây qua Webhooks và Polling.
Toàn bộ dữ liệu được xóa tự động sau 24h. Hỗ trợ xác thực Bearer mạnh mẽ.
Tất cả các yêu cầu API phải bao gốm API Key của bạn trong Header Authorization. Bạn có thể tìm thấy mã này trong phần cài đặt của Dashboard.
Authorization: Bearer ez_live_xxxxxxxxxxxxxxxxxxxxxxxx/api/auth/meTrả về thông tin chi tiết của người dùng hiện tại đang được xác thực qua session hoặc API Key.
curl -X GET "https://ezminbox.com/api/auth/me" \
-H "Authorization: Bearer YOUR_API_KEY"{
"userId": "user_12345",
"email": "user@example.com",
"username": "john_doe",
"role": "user",
"isPremium": true,
"webhookUrl": "https://your-domain.com/webhook"
}/api/accountsTạo một địa chỉ email tạm thời mới. Bạn cần cung cấp địa chỉ mong muốn (bao gồm domain) và mật khẩu.
| Name | Type | Required | Description |
|---|---|---|---|
| address | string | Yes | Địa chỉ email đầy đủ (vd: hello@ezminbox.com) |
| password | string | Yes | Mật khẩu bảo mật cho tài khoản email |
curl -X POST "https://ezminbox.com/api/accounts" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"address": "test_account@ezminbox.com",
"password": "secure_pass_99"
}'{
"id": "acc_556677",
"address": "test_account@ezminbox.com",
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
"createdAt": "2024-03-11T..."
}/api/accounts/meLấy thông tin của hòm thư đang được sử dụng trong session.
curl -X GET "https://ezminbox.com/api/accounts/me" \
-H "Authorization: Bearer YOUR_API_KEY"{
"id": "acc_556677",
"address": "test_account@ezminbox.com",
"expiresAt": "2024-03-12T..."
}/api/messagesLấy tất cả các email hiện có trong hộp thư đang đăng nhập.
curl -X GET "https://ezminbox.com/api/messages" \
-H "Authorization: Bearer YOUR_API_KEY"[
{
"id": "msg_xyz789",
"from_name": "Facebook",
"from_address": "security@facebookmail.com",
"subject": "Your login code: 678902",
"intro": "Hi user, your login code is 678902...",
"otpCode": "678902",
"createdAt": "2024-03-11T..."
}
]/api/messages/[id]Lấy nội dung chi tiết của một email cụ thể (bao gồm HTML và Plain text).
curl -X GET "https://ezminbox.com/api/messages/[id]" \
-H "Authorization: Bearer YOUR_API_KEY"{
"id": "msg_xyz789",
"subject": "Your login code: 678902",
"bodyHtml": "<html>...</html>",
"bodyText": "Hi user, your login code is 678902...",
"otpCode": "678902"
}/api/messages/[id]Xóa một email khỏi danh sách.
curl -X DELETE "https://ezminbox.com/api/messages/[id]" \
-H "Authorization: Bearer YOUR_API_KEY"{
"success": true
}/api/domainsLấy danh sách các tên miền có sẵn để tạo email.
curl -X GET "https://ezminbox.com/api/domains" \
-H "Authorization: Bearer YOUR_API_KEY"[
{
"id": "dom_1",
"domain": "ezminbox.com"
},
{
"id": "dom_2",
"domain": "tempmail.io"
}
]/api/domains/userLiệt kê các tên miền riêng mà bạn đã thêm vào hệ thống.
curl -X GET "https://ezminbox.com/api/domains/user" \
-H "Authorization: Bearer YOUR_API_KEY"[
{
"id": "udom_1",
"domain": "my-custom-work.com",
"status": "ACTIVE"
}
]/api/domains/userThêm một tên miền mới để bắt đầu quá trình xác thực DNS.
| Name | Type | Required | Description |
|---|---|---|---|
| domain | string | Yes | Tên miền bạn sở hữu |
curl -X POST "https://ezminbox.com/api/domains/user" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"domain": "company.com"
}'{
"id": "udom_2",
"verificationToken": "token_123...",
"status": "PENDING"
}/api/user/apiKeyTạo một API Key mới (Key cũ sẽ bị vô hiệu hóa ngay lập tức).
curl -X POST "https://ezminbox.com/api/user/apiKey" \
-H "Authorization: Bearer YOUR_API_KEY"{
"apiKey": "ez_new_key_..."
}/api/user/webhookCấu hình URL để nhận thông báo email thời gian thực.
| Name | Type | Required | Description |
|---|---|---|---|
| webhookUrl | string | Yes | URL bắt đầu bằng https:// |
curl -X POST "https://ezminbox.com/api/user/webhook" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"webhookUrl": "https://my-app.com/api/webhook"
}'{
"success": true,
"webhookUrl": "https://my-app.com/api/webhook"
}Webhooks cho phép nhận thông báo theo thời gian thực mỗi khi có email mới gửi tới địa chỉ của bạn. Đây là cách tối ưu nhất để xây dựng automation mà không cần liên tục gửi request polling.
{
"event": "message.received",
"data": {
"id": "msg_550e8400",
"from": "security@google.com",
"subject": "Your verification code: 998822",
"otp": "998822",
"bodyText": "Hello, your code is 998822...",
"receivedAt": "2024-03-11T12:00:00Z"
}
}EZMinBOX tự động nhận diện và trích xuất mã OTP từ email đến. Mã OTP được trả về trong trường otpCode của mọi API response — bạn không cần parse email thủ công.
POST /api/accounts → Nhận email address + token
Dùng email vừa tạo để nhận mã xác thực OTP từ bất kỳ dịch vụ nào
GET /api/messages → Kiểm tra email mới, field otpCode sẽ chứa mã OTP
Đọc otpCode trực tiếp — không cần regex hay parse HTML!
curl https://ezminbox.com/api/messages/msg_xyz789 \
-H "Authorization: Bearer ez_live_aBcDeFgH..."
# Response:
# {
# "id": "msg_xyz789",
# "accountId": "acc_556677",
# "from_name": "Facebook",
# "from_address": "security@facebookmail.com",
# "to_address": "user@checkmap.store",
# "subject": "Your login code: 482910",
# "bodyHtml": "<p>Your verification code is <b>482910</b></p>",
# "bodyText": "Your verification code is 482910",
# "otpCode": "482910",
# "hasAttachments": false,
# "createdAt": "2026-03-12T01:00:00.000Z"
# }const API_URL = "https://ezminbox.com";
const API_KEY = "ez_live_aBcDeFgH...";
async function waitForOTP(maxAttempts = 30, interval = 2000) {
for (let i = 0; i < maxAttempts; i++) {
const res = await fetch(`${API_URL}/api/messages`, {
headers: { "Authorization": `Bearer ${API_KEY}` }
});
const messages = await res.json();
// Tìm message có OTP
const otpMessage = messages.find(msg => msg.otpCode);
if (otpMessage) {
console.log("✅ OTP found:", otpMessage.otpCode);
return otpMessage.otpCode;
}
console.log(`⏳ Attempt ${i + 1}/${maxAttempts} - waiting...`);
await new Promise(r => setTimeout(r, interval));
}
throw new Error("Timeout: No OTP received");
}
// Usage
const otp = await waitForOTP();
console.log("Mã OTP:", otp); // "482910"import requests, time
API_URL = "https://ezminbox.com"
API_KEY = "ez_live_aBcDeFgH..."
headers = {"Authorization": f"Bearer {API_KEY}"}
def wait_for_otp(max_attempts=30, interval=2):
for i in range(max_attempts):
res = requests.get(f"{API_URL}/api/messages", headers=headers)
messages = res.json()
for msg in messages:
if msg.get("otpCode"):
print(f"✅ OTP found: {msg['otpCode']}")
return msg["otpCode"]
print(f"⏳ Attempt {i+1}/{max_attempts} - waiting...")
time.sleep(interval)
raise TimeoutError("No OTP received")
# Usage
otp = wait_for_otp()
print(f"Mã OTP: {otp}") # "482910"otp cũng được gửi trong Webhook payload.Hệ thống áp dụng giới hạn 100 request/phút cho mỗi API Key. Nếu vượt quá giới hạn, hệ thống sẽ trả về lỗi HTTP 429.