დეველოპერის დოკუმენტაცია

EvilMail API მითითება

ინტეგრირეთ ერთჯერადი ელფოსტა, პერსონალური დომენები, შემოსულის წაკითხვა, DNS მართვა და ვერიფიკაციის კოდების ჭკვიანი ამოღება თქვენს აპლიკაციებში.

ბაზისური URL:https://evilmail.pro

ფორმატი:JSON

ავთენტიფიკაცია:API გასაღები / სესია

პროტოკოლები:მხოლოდ HTTPS

მიმოხილვა

EvilMail API უზრუნველყოფს პროგრამულ წვდომას პლატფორმის ყველა ფუნქციაზე. შექმენით ერთჯერადი ელფოსტა, მართეთ პერსონალური დომენები, წაიკითხეთ შემოსული, ამოიღეთ ვერიფიკაციის კოდები და აკონტროლეთ DNS ჩანაწერები — ყველაფერი მარტივი RESTful ინტერფეისით.

დროებითი ელფოსტის API

ერთჯერადი შემოსულის შექმნა, შეტყობინებების წაკითხვა, ავტომატური ვადის ამოწურვა

დომენისა და ელფოსტის API

პერსონალური დომენები, ელფოსტის ანგარიშები, DNS მართვა

Regex ამოღება

ვერიფიკაციის კოდების ავტომატური ამოღება 8+ სერვისიდან

პასუხის ფორმატი

ყველა პასუხი იცავს თანმიმდევრულ JSON სტრუქტურას:

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

შეცდომის პასუხები მოიცავს messageKey-ს ლოკალიზებული შეცდომის შეტყობინებებისთვის მომხმარებლის ანგარიშის ენის შესაბამისად.

ავთენტიფიკაცია

EvilMail იყენებს ორ ავთენტიფიკაციის მეთოდს ენდპოინტის ტიპის მიხედვით. ყველა API მოთხოვნა უნდა გაიგზავნოს HTTPS-ით.

API გასაღები

დროებითი ელფოსტის შექმნისა და ვერიფიკაციის კოდის ამოღებისთვის. საჭიროა აქტიური ფასიანი გამოწერა.

X-API-Key: your_64char_hex_key

სესიის Cookie

დომენის, ელფოსტის ანგარიშისა და DNS მართვის ენდპოინტებისთვის. იყენება შესვლის შემდეგ.

Cookie: evilmail_session=...

დროებითი ელფოსტის API მოითხოვს ფასიან გეგმას

დროებითი ელფოსტის API და regex ამოღების ენდპოინტები მოითხოვს აქტიურ Bronze, Gold ან Premium გამოწერას. უფასო ანგარიშებს შეუძლიათ მხოლოდ ვებ ინტერფეისის გამოყენება.

დროებითი ელფოსტა

ფასიანი გეგმა საჭიროა

შექმენით ერთჯერადი ელფოსტის მისამართები კონფიგურირებადი TTL-ით. ხელმისაწვდომი დომენები: evilmail.pro, evilmail.cloud.

Create a temporary email address

მოთხოვნის სხეული

domainstringარასავალდებულოDomain to use (default: evilmail.pro)

ttlMinutesnumberარასავალდებულოLifetime: 10, 30, 60, 360, 1440 (default: 60)

პასუხი

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

შემოსული და შეტყობინებები

წაიკითხეთ შემოსული წერილები დროებითი შემოსულიდან. შეტყობინებები მიიღება IMAP-ით და ბრუნდება რეალურ დროში.

დომენის მართვა

დაარეგისტრირეთ პერსონალური დომენები, ვერიფიცირეთ DNS და მართეთ ელფოსტის ინფრასტრუქტურა. დომენის ლიმიტები დამოკიდებულია გეგმაზე.

ელფოსტის ანგარიშები

შექმენით, ჩამოთვალეთ და მართეთ ელფოსტის ანგარიშები ვერიფიცირებული დომენების ქვეშ. მხარს უჭერს ერთეულ და ჯგუფურ შექმნას შემთხვევითი მომხმარებლის სახელის გენერირებით.

ვერიფიკაციის კოდების ჭკვიანი ამოღება

API გასაღები

ავტომატურად ამოიღეთ ვერიფიკაციის კოდები შემოსული წერილებიდან. იდეალურია ავტომატიზირებული ტესტირების, ანგარიშის რეგისტრაციის ნაკადებისა და CI/CD პაიპლაინებისთვის.

Extract verification code from the latest email

პარამეტრები

servicestringსავალდებულოService name (see supported list)

emailstringსავალდებულოEmail address to search (query param)

პასუხი

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

მხარდაჭერილი სერვისები

სერვისი	ენდპოინტი	კოდის შაბლონი	გამგზავნის დომენები
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

სხვა სერვისი გჭირდებათ?

თუ თქვენთვის საჭირო სერვისი ზემოთ არ არის ჩამოთვლილი, შეგვატყობინეთ. ჩვენ რეგულარულად ვაფართოებთ მხარდაჭერილ ინტეგრაციებს დეველოპერების უკუკავშირის საფუძველზე და შეგვიძლია ნებისმიერი ელფოსტაზე დაფუძნებული ვერიფიკაციის სერვისისთვის ახალი regex შაბლონების დამატება.

დაგვიკავშირდით

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 მართვა

სრული DNS ჩანაწერების მართვა PowerDNS-ით. მხარს უჭერს A, AAAA, CNAME, MX, TXT, NS, SRV და CAA ჩანაწერის ტიპებს. ჩანაწერები ვრცელდება 4 გეოგრაფიულად განაწილებული სახელების სერვერით.

კოდის მაგალითები

სრული მუშა მაგალითები დროებითი ელფოსტის შექმნის, შემოსულის წაკითხვისა და ვერიფიკაციის კოდების ამოღებისთვის.

დროებითი ელფოსტის ნაკადი

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

ვერიფიკაციის კოდის ამოღება

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"

დომენის მართვის მაგალითები

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

სიჩქარის ლიმიტები და გეგმები

გეგმის ლიმიტები

ფუნქცია	Free	Bronze	Gold	Premium
პერსონალური დომენები	1	5	25	999
ელფოსტა / დომენი	5	999	999	999
დროებითი ელფოსტის API	მხოლოდ ვებ	სრული	სრული	სრული
Regex API	მხოლოდ ვებ	სრული	სრული	სრული
API სიჩქარის ლიმიტი	100/hr	1,000/hr	5,000/hr	შეუზღუდავი
დროებითი სესიები / IP	10	10	10	10

ენდპოინტის სიჩქარის ლიმიტები

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}გეგმაზე დაფუძნებული

შეცდომების დამუშავება

ყველა შეცდომის პასუხი მოიცავს status ველს "error" მნიშვნელობით, ადამიანისთვის წასაკითხ შეტყობინებას და არჩევით messageKey-ს ლოკალიზებული შეცდომის შეტყობინებებისთვის.

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

კოდი	სტატუსი	აღწერა
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

ლოკალიზებული შეცდომის შეტყობინებები

გამოიყენეთ messageKey ველი შეცდომების საჩვენებლად მომხმარებლის სასურველ ენაზე. მხარდაჭერილი: ინგლისური, თურქული, რუსული, უკრაინული, პოლონური, ფრანგული, გერმანული, აზერბაიჯანული, სპარსული, ფილიპინური, ჰაუსა, აკან.

API Explorer

ტესტირეთ API ენდპოინტები პირდაპირ ბრაუზერიდან. შეიყვანეთ API გასაღები და გაგზავნეთ მოთხოვნები რეალურ დროში პასუხების სანახავად.

API Explorerv1.0

evilmail.pro

POST

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

API გასაღები

მოთხოვნის სხეული

domain

ttlMinutes

გაგზავნეთ მოთხოვნა პასუხის სანახავად

მზად ხართ ინტეგრაციისთვის?

მიიღეთ API გასაღები მართვის პანელიდან და დაიწყეთ შექმნა. სრული წვდომა ნებისმიერი ფასიანი გეგმით.

უფასოდ დაწყება გეგმების ნახვა

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

სერვისი

ენდპოინტი

კოდის შაბლონი

გამგზავნის დომენები

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

ფუნქცია

Free

Bronze

Gold

Premium

პერსონალური დომენები

999

ელფოსტა / დომენი

999

დროებითი ელფოსტის API

მხოლოდ ვებ

სრული

Regex API

მხოლოდ ვებ

სრული

API სიჩქარის ლიმიტი

100/hr

1,000/hr

5,000/hr

შეუზღუდავი

დროებითი სესიები / IP

კოდი

სტატუსი

აღწერა

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