Geliştirici Dokümantasyonu

EvilMail API Referansı

Tek kullanımlık e-posta, özel alan adları, gelen kutusu okuma, DNS yönetimi ve akıllı doğrulama kodu çıkarmayı uygulamalarınıza entegre edin.

Temel URL:https://evilmail.pro

Format:JSON

Kimlik Doğrulama:API Anahtarı / Oturum

Protokoller:Yalnızca HTTPS

Genel Bakış

EvilMail API, tüm platform özelliklerine programatik erişim sağlar. Tek kullanımlık e-postalar oluşturun, özel alan adlarını yönetin, gelen kutularını okuyun, doğrulama kodlarını çıkarın ve DNS kayıtlarını kontrol edin — hepsi basit bir RESTful arayüzü üzerinden.

Geçici E-posta API

Tek kullanımlık gelen kutuları oluşturun, mesajları okuyun, otomatik süre dolumu

Alan Adı ve E-posta API

Özel alan adları, e-posta hesapları, DNS yönetimi

Regex Çıkarma

8+ hizmetten doğrulama kodlarını otomatik çıkarın

Resmi SDK Kütüphaneleri

Node.js

npm install evilmail

npmjs.com/package/evilmail

Python

pip install evilmail

pypi.org/project/evilmail

PHP

composer require evilmail/evilmail-php

packagist.org

go get github.com/Evil-Mail/evilmail-go

pkg.go.dev

Yanıt Formatı

Tüm yanıtlar tutarlı bir JSON yapısını takip eder:

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

Hata yanıtları, kullanıcının hesap diline uygun yerelleştirilmiş hata mesajları için messageKey içerir.

Kimlik Doğrulama

EvilMail, uç nokta türüne bağlı olarak iki kimlik doğrulama yöntemi kullanır. Tüm API istekleri HTTPS üzerinden yapılmalıdır.

API Anahtarı

Geçici e-posta oluşturma ve doğrulama kodu çıkarma için. Aktif ücretli abonelik gerektirir.

X-API-Key: your_64char_hex_key

Oturum Çerezi

Alan adı, e-posta hesabı ve DNS yönetimi uç noktaları için. Giriş sonrası ayarlanır.

Cookie: evilmail_session=...

Geçici E-posta API ücretli plan gerektirir

Geçici e-posta API ve regex çıkarma uç noktaları aktif bir Bronz, Altın veya Premium abonelik gerektirir. Ücretsiz hesaplar yalnızca web arayüzünü kullanabilir.

Geçici E-posta

Ücretli Plan Gerekli

Yapılandırılabilir TTL ile tek kullanımlık e-posta adresleri oluşturun. Kullanılabilir alan adları: evilmail.pro, evilmail.cloud.

Create a temporary email address

İstek Gövdesi

domainstringisteğe bağlıDomain to use (default: evilmail.pro)

ttlMinutesnumberisteğe bağlıLifetime: 10, 30, 60, 360, 1440 (default: 60)

Yanıt

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

Gelen Kutusu ve Mesajlar

Geçici gelen kutunuzdan gelen e-postaları okuyun. Mesajlar IMAP üzerinden alınır ve gerçek zamanlı olarak döndürülür.

Alan Adı Yönetimi

Özel alan adlarını kaydedin, DNS'i doğrulayın ve e-posta altyapınızı yönetin. Alan adı limitleri planınıza bağlıdır.

E-posta Hesapları

Doğrulanmış alan adlarınız altında e-posta hesapları oluşturun, listeleyin ve yönetin. Rastgele kullanıcı adı oluşturma ile tekli ve toplu oluşturmayı destekler.

Akıllı Doğrulama Kodu Çıkarma

API Anahtarı

Gelen e-postalardan doğrulama kodlarını otomatik olarak çıkarın. Otomatik test, hesap kayıt akışları ve CI/CD süreçleri için mükemmel.

Extract verification code from the latest email

Parametreler

servicestringzorunluService name (see supported list)

emailstringzorunluEmail address to search (query param)

Yanıt

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

Desteklenen Hizmetler

Hizmet	Uç Nokta	Kod Deseni	Gönderen Alan Adları
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

Farklı Bir Hizmete mi İhtiyacınız Var?

Aradığınız hizmet yukarıdaki listede yer almıyorsa bize bildirin. Geliştirici geri bildirimlerine göre desteklenen entegrasyonlarımızı düzenli olarak genişletiyoruz ve e-posta tabanlı doğrulama hizmetleri için yeni regex desenleri ekleyebiliyoruz.

İletişime Geçin

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"

DNS Yönetimi

PowerDNS üzerinden tam DNS kayıt yönetimi. A, AAAA, CNAME, MX, TXT, NS, SRV ve CAA kayıt türlerini destekler. Kayıtlar 4 coğrafi olarak dağıtılmış nameserver üzerinden yayılır.

Kod Örnekleri

Geçici e-posta oluşturma, gelen kutusu okuma ve doğrulama kodu çıkarma için eksiksiz çalışan örnekler.

Geçici E-posta Akışı

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

Doğrulama Kodu Çıkarma

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"

Alan Adı Yönetimi Örnekleri

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

Hız Limitleri ve Planlar

Plan Limitleri

Özellik	Free	Bronze	Gold	Premium
Özel Alan Adları	1	5	25	999
E-posta / Alan Adı	5	999	999	999
Geçici E-posta API	Yalnızca web	Tam	Tam	Tam
Regex API	Yalnızca web	Tam	Tam	Tam
API Hız Limiti	100/hr	1,000/hr	5,000/hr	Sınırsız
Geçici Oturum / IP	10	10	10	10

Uç Nokta Hız Limitleri

IP adresi başına

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}Plana dayalı

Hata Yönetimi

Tüm hata yanıtları "error" olarak ayarlanmış bir status alanı, okunabilir bir mesaj ve kullanıcının hesap diline uygun yerelleştirilmiş hata mesajları için isteğe bağlı bir messageKey içerir.

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

Kod	Durum	Açıklama
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

Yerelleştirilmiş Hata Mesajları

Hataları kullanıcının tercih ettiği dilde görüntülemek için messageKey alanını kullanın. Desteklenen diller: İngilizce, Türkçe, Rusça, Ukraynaca, Lehçe, Fransızca, Almanca, Azerbaycanca, Farsça, Filipince, Hausaca, Akanca.

API Explorer

API uç noktalarını doğrudan tarayıcınızdan test edin. API anahtarınızı girin ve canlı yanıtları görmek için istek gönderin.

API Explorerv1.0

evilmail.pro

POST

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

API Anahtarı

İstek Gövdesi

domain

ttlMinutes

Yanıtı görmek için bir istek gönderin

Entegrasyona hazır mısınız?

Panelden API anahtarınızı alın ve geliştirmeye başlayın. Herhangi bir ücretli plan ile tam erişim.

Ücretsiz Başlayın Planları Görüntüle

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

Hizmet

Uç Nokta

Kod Deseni

Gönderen Alan Adları

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

Özellik

Free

Bronze

Gold

Premium

Özel Alan Adları

999

E-posta / Alan Adı

999

Geçici E-posta API

Yalnızca web

Tam

Regex API

Yalnızca web

Tam

API Hız Limiti

100/hr

1,000/hr

5,000/hr

Sınırsız

Geçici Oturum / IP

Kod

Durum

Açıklama

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