የገንቢ ሰነድ

የEvilMail API ማጣቀሻ

ጊዜያዊ ኢሜይል፣ ብጁ ጎራዎች፣ የገቢ መልእክት ማንበብ፣ የDNS አስተዳደር እና ብልህ የማረጋገጫ ኮድ ማውጣትን ወደ መተግበሪያዎችዎ ያዋህዱ።

መሰረታዊ URL:https://evilmail.pro

ቅርጸት:JSON

ማረጋገጫ:API ቁልፍ / ክፍለ ጊዜ

ፕሮቶኮሎች:HTTPS ብቻ

አጠቃላይ እይታ

የEvilMail API ለሁሉም የመድረክ ባህሪያት የፕሮግራም መዳረሻ ይሰጣል። ጊዜያዊ ኢሜይሎችን ይፍጠሩ፣ ብጁ ጎራዎችን ያስተዳድሩ፣ የገቢ መልእክት ሳጥኖችን ያንብቡ፣ የማረጋገጫ ኮዶችን ያውጡ እና የDNS መዝገቦችን ይቆጣጠሩ — ሁሉም በቀላል RESTful በይነገጽ በኩል።

የጊዜያዊ ኢሜይል API

ጊዜያዊ የገቢ መልእክት ሳጥኖችን ፍጠር፣ መልእክቶችን አንብብ፣ በራስ-ሰር አብቃ

የጎራ እና ኢሜይል API

ብጁ ጎራዎች፣ የኢሜይል አካውንቶች፣ የDNS አስተዳደር

Regex ማውጣት

ከ8+ አገልግሎቶች የማረጋገጫ ኮዶችን በራስ-ሰር አውጣ

Official SDK Libraries

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

የምላሽ ቅርጸት

ሁሉም ምላሾች ወጥ የሆነ JSON መዋቅር ይከተላሉ፡

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

የስህተት ምላሾች ከተጠቃሚው አካውንት ቋንቋ ጋር የሚዛመዱ የተተረጎሙ የስህተት መልእክቶች messageKey ያካትታሉ።

ማረጋገጫ

API ቁልፍዎን በAuthorization ራስጌ ውስጥ ያካትቱ።

API ቁልፍ

ለጊዜያዊ ኢሜይል መፍጠር እና የማረጋገጫ ኮድ ማውጣት። ንቁ የተከፈለ የደንበኝነት ምዝገባ ይፈልጋል።

X-API-Key: your_64char_hex_key

የክፍለ ጊዜ ኩኪ

ለጎራ፣ ለኢሜይል አካውንት እና ለDNS አስተዳደር መዳረሻዎች። ከመግቢያ በኋላ ይዘጋጃል።

Cookie: evilmail_session=...

የጊዜያዊ ኢሜይል API የተከፈለ ዕቅድ ይፈልጋል

የጊዜያዊ ኢሜይል API እና የregex ማውጫ መዳረሻዎች ንቁ የBronze፣ Gold ወይም Premium የደንበኝነት ምዝገባ ይፈልጋሉ። ነጻ አካውንቶች የድር በይነገጹን ብቻ መጠቀም ይችላሉ።

ጊዜያዊ ኢሜይል

የተከፈለ ዕቅድ ያስፈልጋል

ሊዋቀር በሚችል TTL ጊዜያዊ የኢሜይል አድራሻዎችን ይፍጠሩ።

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

Free domains work on any plan; premium domains require an active paid subscription. See GET /api/domains/available for the full current list.

የገቢ መልእክት እና መልእክቶች

ከጊዜያዊ የገቢ መልእክት ሳጥንዎ ወይም በብጁ ጎራዎች ላይ ካሉ የራስዎ የኢሜይል አካውንቶች የሚመጡ ኢሜይሎችን ያንብቡ። ጊዜያዊ የገቢ መልእክት የክፍለ ጊዜ ኩኪዎችን ይጠቀማል፣ የብጁ ጎራ አካውንቶች የAPI ቁልፍ ማረጋገጫ ይጠቀማሉ።

የጎራ አስተዳደር

ብጁ ጎራዎችን ይመዝግቡ፣ 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 አስተዳደር

በPowerDNS በኩል ሙሉ የDNS መዝገብ አስተዳደር። 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}በዕቅድ ላይ የተመሰረተ

የስህተት አያያዝ

ሁሉም የስህተት ምላሾች ወደ \"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