Tài liệu nhà phát triển

Tham chiếu API EvilMail

Tích hợp email dùng một lần, tên miền tùy chỉnh, đọc hộp thư, quản lý DNS, và trích xuất mã xác minh thông minh vào ứng dụng.

Base URL:https://evilmail.pro

Định dạng:JSON

Xác thực:API Key / Phiên

Giao thức:Chỉ HTTPS

Tổng quan

API EvilMail cung cấp truy cập lập trình đến tất cả tính năng nền tảng. Tạo email dùng một lần, quản lý tên miền tùy chỉnh, đọc hộp thư, trích xuất mã xác minh, và điều khiển bản ghi DNS — qua giao diện RESTful đơn giản.

API Email tạm thời

Tạo hộp thư dùng một lần, đọc tin nhắn, tự hết hạn

API Tên miền & Email

Tên miền tùy chỉnh, tài khoản email, quản lý DNS

Trích xuất Regex

Tự động trích xuất mã xác minh từ 8+ dịch vụ

Định dạng phản hồi

Tất cả phản hồi tuân theo cấu trúc JSON nhất quán:

{
  "status": "success" | "error",
  "message": "Human-readable message (optional)",
  "messageKey": "i18n key for localized errors (optional)",
  "data": { ... }
}

Phản hồi lỗi bao gồm messageKey cho thông báo lỗi bản địa hóa khớp với ngôn ngữ tài khoản người dùng.

Xác thực

EvilMail sử dụng hai phương thức xác thực tùy loại endpoint. Tất cả yêu cầu API phải qua HTTPS.

API Key

Cho tạo email tạm thời và trích xuất mã xác minh. Yêu cầu đăng ký trả phí.

X-API-Key: your_64char_hex_key

Cookie phiên

Cho endpoint quản lý tên miền, tài khoản email, và DNS. Được thiết lập sau đăng nhập.

Cookie: evilmail_session=...

API Email tạm thời yêu cầu gói trả phí

Endpoint API email tạm thời và trích xuất regex yêu cầu đăng ký Bronze, Gold, hoặc Premium. Tài khoản miễn phí chỉ dùng giao diện web.

Email tạm thời

Yêu cầu gói trả phí

Tạo địa chỉ email dùng một lần với TTL tùy chỉnh. Tên miền khả dụng: evilmail.pro, evilmail.cloud.

Create a temporary email address

Body yêu cầu

domainstringtùy chọnDomain to use (default: evilmail.pro)

ttlMinutesnumbertùy chọnLifetime: 10, 30, 60, 360, 1440 (default: 60)

Phản hồi

{
  "status": "success",
  "data": {
    "email": "[email protected]",
    "domain": "evilmail.pro",
    "sessionToken": "a1b2c3d4...",
    "ttlMinutes": 60,
    "expiresAt": "2026-03-07T15:30:00.000Z"
  }
}

Available domains: evilmail.pro, evilmail.cloud. Requires an active paid subscription.

Hộp thư & Tin nhắn

Đọc email đến từ hộp thư tạm thời. Tin nhắn được lấy qua IMAP và trả về thời gian thực.

Quản lý tên miền

Đăng ký tên miền tùy chỉnh, xác minh DNS, và quản lý hạ tầng email. Giới hạn tên miền phụ thuộc vào gói.

Tài khoản Email

Tạo, liệt kê, và quản lý tài khoản email dưới tên miền đã xác minh. Hỗ trợ tạo đơn lẻ và hàng loạt với tạo tên người dùng ngẫu nhiên.

Trích xuất mã xác minh thông minh

API Key

Tự động trích xuất mã xác minh từ email đến. Hoàn hảo cho kiểm thử tự động, quy trình đăng ký tài khoản, và pipeline CI/CD.

Extract verification code from the latest email

Tham số

servicestringbắt buộcService name (see supported list)

emailstringbắt buộcEmail address to search (query param)

Phản hồi

{
  "status": "success",
  "data": {
    "code": "847291",
    "service": "google",
    "email": "[email protected]",
    "from": "[email protected]",
    "subject": "Your verification code",
    "date": "2026-03-07T14:22:00.000Z"
  }
}

Searches the last 20 messages. You must own the domain.

Dịch vụ được hỗ trợ

Dịch vụ	Endpoint	Mẫu mã	Tên miền người gửi
Google	/api/regex/google	G-XXXXXX	google.com, accounts.google.com
Facebook	/api/regex/facebook	XXXXXX	facebookmail.com, facebook.com
Twitter/X	/api/regex/twitter	XXXXXXXX	twitter.com, x.com
Instagram	/api/regex/instagram	XXXXXX	instagram.com, mail.instagram.com
TikTok	/api/regex/tiktok	XXXX-XXXXXX	tiktok.com
Discord	/api/regex/discord	XXXXXX	discord.com
LinkedIn	/api/regex/linkedin	XXXXXX	linkedin.com
iCloud	/api/regex/icloud	XXXXXX	apple.com, id.apple.com

Cần dịch vụ khác?

Nếu dịch vụ bạn tìm không có trong danh sách, hãy cho chúng tôi biết. Chúng tôi thường xuyên mở rộng tích hợp dựa trên phản hồi của nhà phát triển và có thể thêm mẫu regex mới cho bất kỳ dịch vụ xác minh qua email nào.

Liên hệ chúng tôi

api-example

# Extract Google verification code
curl "https://evilmail.pro/api/regex/[email protected]" \
  -H "X-API-Key: YOUR_API_KEY"

# Extract Discord verification code
curl "https://evilmail.pro/api/regex/[email protected]" \
  -H "X-API-Key: YOUR_API_KEY"

# Extract TikTok code
curl "https://evilmail.pro/api/regex/[email protected]" \
  -H "X-API-Key: YOUR_API_KEY"

Quản lý DNS

Quản lý bản ghi DNS đầy đủ qua PowerDNS. Hỗ trợ loại bản ghi A, AAAA, CNAME, MX, TXT, NS, SRV, và CAA. Bản ghi lan truyền qua 4 nameserver phân bố địa lý.

Ví dụ mã

Ví dụ hoạt động đầy đủ cho tạo email tạm thời, đọc hộp thư, và trích xuất mã xác minh.

Quy trình Email tạm thời

api-example

# Create a temporary email
curl -X POST https://evilmail.pro/api/temp-email \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"domain": "evilmail.pro", "ttlMinutes": 60}'

# Response: { "data": { "email": "...", "sessionToken": "abc123..." } }

# Poll for incoming messages using the session token
curl https://evilmail.pro/api/temp-email/abc123...

# Response includes messages array
# { "data": { "email": "...", "messages": [...] } }

Trích xuất mã xác minh

api-example

# Extract Google verification code
curl "https://evilmail.pro/api/regex/[email protected]" \
  -H "X-API-Key: YOUR_API_KEY"

# Extract Discord verification code
curl "https://evilmail.pro/api/regex/[email protected]" \
  -H "X-API-Key: YOUR_API_KEY"

# Extract TikTok code
curl "https://evilmail.pro/api/regex/[email protected]" \
  -H "X-API-Key: YOUR_API_KEY"

Ví dụ quản lý tên miền

api-example

# Add a domain
curl -X POST https://evilmail.pro/api/domains \
  -H "Content-Type: application/json" \
  -H "Cookie: evilmail_session=YOUR_SESSION" \
  -d '{"domain": "mydomain.com"}'

# List domains
curl https://evilmail.pro/api/domains \
  -H "Cookie: evilmail_session=YOUR_SESSION"

# Verify DNS
curl -X POST https://evilmail.pro/api/domains/check \
  -H "Content-Type: application/json" \
  -H "Cookie: evilmail_session=YOUR_SESSION" \
  -d '{"domain": "mydomain.com"}'

# Create email account
curl -X POST https://evilmail.pro/api/accounts \
  -H "Content-Type: application/json" \
  -H "Cookie: evilmail_session=YOUR_SESSION" \
  -d '{"email": "[email protected]", "password": "secure123"}'

Giới hạn tốc độ & Gói

Giới hạn gói

Tính năng	Free	Bronze	Gold	Premium
Tên miền tùy chỉnh	1	5	25	999
Email / Tên miền	5	999	999	999
API Email tạm thời	Chỉ web	Đầy đủ	Đầy đủ	Đầy đủ
Regex API	Chỉ web	Đầy đủ	Đầy đủ	Đầy đủ
Giới hạn tốc độ API	100/hr	1,000/hr	5,000/hr	Không giới hạn
Phiên tạm / IP	10	10	10	10

Giới hạn tốc độ Endpoint

Mỗi địa chỉ IP

POST /api/auth/login10 / 15 min

POST /api/auth/register5 / 1 hour

POST /api/auth/forgot-password3 / 1 hour

POST /api/auth/reset-password5 / 15 min

PUT /api/account/password5 / 15 min

POST /api/contact5 / 1 hour

POST /api/temp-email10 sessions / IP

GET /api/regex/{service}Theo gói

Xử lý lỗi

Tất cả phản hồi lỗi bao gồm trường status là "error", thông báo dễ đọc, và messageKey tùy chọn cho thông báo lỗi bản địa hóa khớp với ngôn ngữ tài khoản.

{
  "status": "error",
  "message": "Domain limit reached. Upgrade your plan for more.",
  "messageKey": "domainLimitReached"
}

Mã	Trạng thái	Mô tả
200	Success	Request completed successfully
400	Bad Request	Missing or invalid parameters
401	Unauthorized	Invalid or missing authentication
403	Forbidden	Insufficient permissions or plan limits
404	Not Found	Resource does not exist
409	Conflict	Resource already exists (duplicate)
429	Rate Limited	Too many requests, slow down
500	Server Error	Internal server error

Thông báo lỗi bản địa hóa

Dùng trường messageKey để hiển thị lỗi bằng ngôn ngữ ưa thích. Hỗ trợ: Anh, Thổ Nhĩ Kỳ, Nga, Ukraine, Ba Lan, Pháp, Đức, Azerbaijan, Ba Tư, Philippines, Hausa, Akan.

API Explorer

Kiểm thử endpoint API ngay từ trình duyệt. Nhập API key và gửi yêu cầu để xem phản hồi trực tiếp.

API Explorerv1.0

evilmail.pro

POST

POSThttps://evilmail.pro/api/temp-email

API Key

Body yêu cầu

domain

ttlMinutes

Gửi yêu cầu để xem phản hồi

Sẵn sàng tích hợp?

Lấy API key từ bảng điều khiển và bắt đầu xây dựng. Truy cập đầy đủ với mọi gói trả phí.

Bắt đầu miễn phí Xem gói

{ "status": "success", "data": { "email": "[email protected]", "domain": "evilmail.pro", "sessionToken": "a1b2c3d4...", "ttlMinutes": 60, "expiresAt": "2026-03-07T15:30:00.000Z" } }

{ "status": "success", "data": { "code": "847291", "service": "google", "email": "[email protected]", "from": "[email protected]", "subject": "Your verification code", "date": "2026-03-07T14:22:00.000Z" } }

Dịch vụ

Endpoint

Mẫu mã

Tên miền người gửi

Google

/api/regex/google

G-XXXXXX

google.com, accounts.google.com

Facebook

/api/regex/facebook

XXXXXX

facebookmail.com, facebook.com

Twitter/X

/api/regex/twitter

XXXXXXXX

twitter.com, x.com

Instagram

/api/regex/instagram

XXXXXX

instagram.com, mail.instagram.com

TikTok

/api/regex/tiktok

XXXX-XXXXXX

tiktok.com

Discord

/api/regex/discord

XXXXXX

discord.com

/api/regex/linkedin

XXXXXX

linkedin.com

iCloud

/api/regex/icloud

XXXXXX

apple.com, id.apple.com

# Extract Google verification code curl "https://evilmail.pro/api/regex/[email protected]" \ -H "X-API-Key: YOUR_API_KEY" # Extract Discord verification code curl "https://evilmail.pro/api/regex/[email protected]" \ -H "X-API-Key: YOUR_API_KEY" # Extract TikTok code curl "https://evilmail.pro/api/regex/[email protected]" \ -H "X-API-Key: YOUR_API_KEY"

# Create a temporary email curl -X POST https://evilmail.pro/api/temp-email \ -H "Content-Type: application/json" \ -H "X-API-Key: YOUR_API_KEY" \ -d '{"domain": "evilmail.pro", "ttlMinutes": 60}' # Response: { "data": { "email": "...", "sessionToken": "abc123..." } } # Poll for incoming messages using the session token curl https://evilmail.pro/api/temp-email/abc123... # Response includes messages array # { "data": { "email": "...", "messages": [...] } }

# Add a domain curl -X POST https://evilmail.pro/api/domains \ -H "Content-Type: application/json" \ -H "Cookie: evilmail_session=YOUR_SESSION" \ -d '{"domain": "mydomain.com"}' # List domains curl https://evilmail.pro/api/domains \ -H "Cookie: evilmail_session=YOUR_SESSION" # Verify DNS curl -X POST https://evilmail.pro/api/domains/check \ -H "Content-Type: application/json" \ -H "Cookie: evilmail_session=YOUR_SESSION" \ -d '{"domain": "mydomain.com"}' # Create email account curl -X POST https://evilmail.pro/api/accounts \ -H "Content-Type: application/json" \ -H "Cookie: evilmail_session=YOUR_SESSION" \ -d '{"email": "[email protected]", "password": "secure123"}'

Tính năng

Free

Bronze

Gold

Premium

Tên miền tùy chỉnh

999

Email / Tên miền

999

API Email tạm thời

Chỉ web

Đầy đủ

Regex API

Chỉ web

Đầy đủ

Giới hạn tốc độ API

100/hr

1,000/hr

5,000/hr

Không giới hạn

Phiên tạm / IP

Mã

Trạng thái

Mô tả

200

Success

Request completed successfully

400

Bad Request

Missing or invalid parameters

401

Unauthorized

Invalid or missing authentication

403

Forbidden

Insufficient permissions or plan limits

404

Not Found

Resource does not exist

409

Conflict

Resource already exists (duplicate)

429

Rate Limited

Too many requests, slow down

500

Server Error

Internal server error