Dokumentasi Pembangun

Rujukan API EvilMail

Integrasikan e-mel sekali guna, domain tersuai, pembacaan peti masuk, pengurusan DNS dan pengekstrakan kod pengesahan pintar ke dalam aplikasi anda.

URL Asas:https://evilmail.pro

Format:JSON

Pengesahan:Kunci API / Sesi

Protokol:HTTPS sahaja

Gambaran Keseluruhan

API EvilMail menyediakan akses atur cara kepada semua ciri platform. Cipta e-mel sekali guna, urus domain tersuai, baca peti masuk, ekstrak kod pengesahan dan kawal rekod DNS — semuanya melalui antara muka RESTful yang mudah.

API E-mel Sementara

Cipta peti masuk sekali guna, baca mesej, tamat tempoh automatik

API Domain & E-mel

Domain tersuai, akaun e-mel, pengurusan DNS

Pengekstrakan Regex

Ekstrak automatik kod pengesahan daripada 8+ perkhidmatan

Format Respons

Semua respons mengikut struktur JSON yang konsisten:

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

Respons ralat termasuk messageKey untuk mesej ralat setempat yang sepadan dengan bahasa akaun pengguna.

Pengesahan

EvilMail menggunakan dua kaedah pengesahan bergantung pada jenis titik akhir. Semua permintaan API mesti dibuat melalui HTTPS.

Kunci API

Untuk penciptaan e-mel sementara dan pengekstrakan kod pengesahan. Memerlukan langganan berbayar aktif.

X-API-Key: your_64char_hex_key

Kuki Sesi

Untuk titik akhir pengurusan domain, akaun e-mel dan DNS. Ditetapkan selepas log masuk.

Cookie: evilmail_session=...

API E-mel Sementara memerlukan pelan berbayar

API e-mel sementara dan titik akhir pengekstrakan regex memerlukan langganan Bronze, Gold atau Premium yang aktif. Akaun percuma hanya boleh menggunakan antara muka web.

E-mel Sementara

Pelan Berbayar Diperlukan

Cipta alamat e-mel sekali guna dengan TTL yang boleh dikonfigurasi. Domain tersedia: evilmail.pro, evilmail.cloud.

Create a temporary email address

Badan Permintaan

domainstringpilihanDomain to use (default: evilmail.pro)

ttlMinutesnumberpilihanLifetime: 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.

Peti Masuk & Mesej

Baca e-mel masuk dari peti masuk sementara anda. Mesej diambil melalui IMAP dan dikembalikan dalam masa nyata.

Pengurusan Domain

Daftar domain tersuai, sahkan DNS dan urus infrastruktur e-mel anda. Had domain bergantung pada pelan anda.

Akaun E-mel

Cipta, senarai dan urus akaun e-mel di bawah domain yang disahkan. Menyokong penciptaan tunggal dan pukal dengan penjanaan nama pengguna rawak.

Pengekstrakan Kod Pengesahan Pintar

Kunci API

Ekstrak automatik kod pengesahan daripada e-mel masuk. Sempurna untuk ujian automatik, aliran pendaftaran akaun dan saluran CI/CD.

Extract verification code from the latest email

Parameter

servicestringdiperlukanService name (see supported list)

emailstringdiperlukanEmail 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.

Perkhidmatan Disokong

Perkhidmatan	Titik Akhir	Corak Kod	Domain Penghantar
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

Perlukan Perkhidmatan Lain?

Jika perkhidmatan yang anda cari tidak disenaraikan di atas, maklumkan kami. Kami kerap mengembangkan integrasi yang disokong berdasarkan maklum balas pembangun dan boleh menambah corak regex baharu untuk mana-mana perkhidmatan pengesahan berasaskan e-mel.

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"

Pengurusan DNS

Pengurusan rekod DNS penuh melalui PowerDNS. Menyokong jenis rekod A, AAAA, CNAME, MX, TXT, NS, SRV dan CAA. Rekod disebarkan melalui 4 pelayan nama yang diedarkan secara geografi.

Contoh Kod

Contoh kerja lengkap untuk mencipta e-mel sementara, membaca peti masuk dan mengekstrak kod pengesahan.

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

Pengekstrakan Kod Pengesahan

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

Had Kadar & Pelan

Had Pelan

Ciri	Free	Bronze	Gold	Premium
Domain Tersuai	1	5	25	999
E-mel / Domain	5	999	999	999
API E-mel Sementara	Web sahaja	Penuh	Penuh	Penuh
Regex API	Web sahaja	Penuh	Penuh	Penuh
Had Kadar API	100/hr	1,000/hr	5,000/hr	Tanpa Had
Sesi Sementara / IP	10	10	10	10

Had Kadar Titik Akhir

Setiap 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 pelan

Pengendalian Ralat

Semua respons ralat termasuk medan status yang ditetapkan kepada "error", mesej yang boleh dibaca manusia dan messageKey pilihan untuk mesej ralat setempat yang sepadan dengan bahasa akaun pengguna.

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

Kod	Status	Penerangan
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

Mesej Ralat Setempat

Gunakan medan messageKey untuk memaparkan ralat dalam bahasa pilihan pengguna. Disokong: Inggeris, Turki, Rusia, Ukraine, Poland, Perancis, Jerman, Azerbaijan, Farsi, Filipina, Hausa, Akan.

API Explorer

Uji titik akhir API terus dari pelayar anda. Masukkan kunci API anda dan hantar permintaan untuk melihat respons langsung.

API Explorerv1.0

evilmail.pro

POST

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

Kunci API

Badan Permintaan

domain

ttlMinutes

Hantar permintaan untuk melihat respons

Bersedia untuk mengintegrasikan?

Dapatkan kunci API anda dari papan pemuka dan mula membina. Akses penuh dengan mana-mana pelan berbayar.

Mulakan Percuma Lihat Pelan

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

Perkhidmatan

Titik Akhir

Corak Kod

Domain Penghantar

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

Ciri

Free

Bronze

Gold

Premium

Domain Tersuai

999

E-mel / Domain

999

API E-mel Sementara

Web sahaja

Penuh

Regex API

Web sahaja

Penuh

Had Kadar API

100/hr

1,000/hr

5,000/hr

Tanpa Had

Sesi Sementara / IP

Kod

Status

Penerangan

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