Dokumentasi Developer

Referensi API EvilMail

Integrasikan email sekali pakai, domain kustom, pembacaan kotak masuk, manajemen DNS, dan ekstraksi kode verifikasi cerdas ke dalam aplikasi Anda.

Base URL:https://evilmail.pro

Format:JSON

Autentikasi:API Key / Sesi

Protokol:Hanya HTTPS

Ringkasan

API EvilMail menyediakan akses programatis ke semua fitur platform. Buat email sekali pakai, kelola domain kustom, baca kotak masuk, ekstrak kode verifikasi, dan kontrol rekaman DNS — semuanya melalui antarmuka RESTful yang sederhana.

API Email Sementara

Buat kotak masuk sekali pakai, baca pesan, kedaluwarsa otomatis

API Domain & Email

Domain kustom, akun email, manajemen DNS

Ekstraksi Regex

Ekstraksi otomatis kode verifikasi dari 8+ layanan

Format Respons

Semua respons mengikuti struktur JSON yang konsisten:

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

Respons error menyertakan messageKey untuk pesan error yang dilokalkan sesuai bahasa akun pengguna.

Autentikasi

EvilMail menggunakan dua metode autentikasi tergantung jenis endpoint. Semua permintaan API harus dilakukan melalui HTTPS.

API Key

Untuk pembuatan email sementara dan ekstraksi kode verifikasi. Memerlukan langganan berbayar aktif.

X-API-Key: your_64char_hex_key

Cookie Sesi

Untuk endpoint manajemen domain, akun email, dan DNS. Ditetapkan setelah login.

Cookie: evilmail_session=...

API Email Sementara memerlukan paket berbayar

Endpoint API email sementara dan ekstraksi regex memerlukan langganan Bronze, Gold, atau Premium aktif. Akun gratis hanya dapat menggunakan antarmuka web.

Email Sementara

Paket Berbayar Diperlukan

Buat alamat email sekali pakai dengan TTL yang dapat dikonfigurasi. Domain tersedia: evilmail.pro, evilmail.cloud.

Create a temporary email address

Body Permintaan

domainstringopsionalDomain to use (default: evilmail.pro)

ttlMinutesnumberopsionalLifetime: 10, 30, 60, 360, 1440 (default: 60)

Respons

{
  "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.

Kotak Masuk & Pesan

Baca email masuk dari kotak masuk sementara Anda. Pesan diambil melalui IMAP dan dikembalikan secara real-time.

Manajemen Domain

Daftarkan domain kustom, verifikasi DNS, dan kelola infrastruktur email Anda. Batas domain tergantung pada paket Anda.

Akun Email

Buat, daftar, dan kelola akun email di bawah domain terverifikasi Anda. Mendukung pembuatan tunggal dan massal dengan pembuatan nama pengguna acak.

Ekstraksi Kode Verifikasi Cerdas

API Key

Ekstrak kode verifikasi secara otomatis dari email masuk. Sempurna untuk pengujian otomatis, alur pendaftaran akun, dan pipeline CI/CD.

Extract verification code from the latest email

Parameter

servicestringwajibService name (see supported list)

emailstringwajibEmail address to search (query param)

Respons

{
  "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.

Layanan yang Didukung

Layanan	Endpoint	Pola Kode	Domain Pengirim
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

Butuh Layanan Lain?

Jika layanan yang Anda cari tidak tercantum di atas, beri tahu kami. Kami secara rutin memperluas integrasi yang didukung berdasarkan masukan developer dan dapat menambahkan pola regex baru untuk layanan verifikasi berbasis email apa pun.

Hubungi Kami

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"

Manajemen DNS

Manajemen rekaman DNS lengkap melalui PowerDNS. Mendukung tipe rekaman A, AAAA, CNAME, MX, TXT, NS, SRV, dan CAA. Rekaman dipropagasi melalui 4 nameserver yang terdistribusi geografis.

Contoh Kode

Contoh kerja lengkap untuk membuat email sementara, membaca kotak masuk, dan mengekstrak kode verifikasi.

Alur Email Sementara

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": [...] } }

Ekstraksi Kode Verifikasi

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"

Contoh Manajemen Domain

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"}'

Batas Kecepatan & Paket

Batas Paket

Fitur	Free	Bronze	Gold	Premium
Domain Kustom	1	5	25	999
Email / Domain	5	999	999	999
API Email Sementara	Hanya web	Penuh	Penuh	Penuh
Regex API	Hanya web	Penuh	Penuh	Penuh
Batas Kecepatan API	100/hr	1,000/hr	5,000/hr	Tidak Terbatas
Sesi Sementara / IP	10	10	10	10

Batas Kecepatan Endpoint

Per alamat 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}Berdasarkan paket

Penanganan Error

Semua respons error menyertakan kolom status yang diatur ke "error", pesan yang dapat dibaca manusia, dan messageKey opsional untuk pesan error yang dilokalkan sesuai bahasa akun pengguna.

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

Kode	Status	Deskripsi
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

Pesan Error Lokal

Gunakan kolom messageKey untuk menampilkan error dalam bahasa pilihan pengguna. Didukung: Inggris, Turki, Rusia, Ukraina, Polandia, Prancis, Jerman, Azerbaijan, Persia, Filipina, Hausa, Akan.

API Explorer

Uji endpoint API langsung dari browser Anda. Masukkan API key Anda dan kirim permintaan untuk melihat respons langsung.

API Explorerv1.0

evilmail.pro

POST

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

API Key

Body Permintaan

domain

ttlMinutes

Kirim permintaan untuk melihat respons

Siap untuk mengintegrasikan?

Dapatkan API key Anda dari dasbor dan mulai membangun. Akses penuh dengan paket berbayar apa pun.

Mulai Gratis Lihat Paket

{ "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" } }

Layanan

Endpoint

Pola Kode

Domain Pengirim

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"}'

Fitur

Free

Bronze

Gold

Premium

Domain Kustom

999

Email / Domain

999

API Email Sementara

Hanya web

Penuh

Regex API

Hanya web

Penuh

Batas Kecepatan API

100/hr

1,000/hr

5,000/hr

Tidak Terbatas

Sesi Sementara / IP

Kode

Status

Deskripsi

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