Developer စာရွက်စာတမ်း

EvilMail API ကိုးကားချက်

ဖျက်ပစ်နိုင်သောအီးမေးလ်၊ စိတ်ကြိုက် domain များ၊ inbox ဖတ်ရှုခြင်း၊ DNS စီမံခန့်ခွဲမှုနှင့် စမတ်အတည်ပြုကုဒ်ထုတ်ယူခြင်းကို သင့် application များတွင် ချိတ်ဆက်ပါ။

Base URL:https://evilmail.pro

ပုံစံ:JSON

အထောက်အထားစိစစ်ခြင်း:API Key / Session

Protocol များ:HTTPS သာ

ခြုံငုံသုံးသပ်ချက်

EvilMail API သည် platform လုပ်ဆောင်ချက်အားလုံးကို programmatically အသုံးပြုခွင့် ပေးသည်။ ဖျက်ပစ်နိုင်သောအီးမေးလ်များ ဖန်တီးခြင်း၊ စိတ်ကြိုက် domain များ စီမံခန့်ခွဲခြင်း၊ inbox များဖတ်ခြင်း၊ အတည်ပြုကုဒ်များ ထုတ်ယူခြင်းနှင့် DNS မှတ်တမ်းများ ထိန်းချုပ်ခြင်း — အားလုံးကို ရိုးရှင်းသော RESTful interface မှတစ်ဆင့်။

ယာယီ အီးမေးလ် API

ဖျက်ပစ်နိုင်သော inbox များ ဖန်တီး၊ မက်ဆေ့ချ်များ ဖတ်၊ အလိုအလျောက် သက်တမ်းကုန်

Domain နှင့် အီးမေးလ် API

စိတ်ကြိုက် domain များ၊ အီးမေးလ်အကောင့်များ၊ DNS စီမံခန့်ခွဲမှု

Regex ထုတ်ယူခြင်း

ဝန်ဆောင်မှု ၈ မျိုးကျော်မှ အတည်ပြုကုဒ်များကို အလိုအလျောက် ထုတ်ယူပါ

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

Error တုံ့ပြန်မှုများတွင် အသုံးပြုသူ၏ အကောင့်ဘာသာစကားနှင့် ကိုက်ညီသော ဒေသန္တရ error မက်ဆေ့ချ်များအတွက် messageKey ပါဝင်သည်။

အထောက်အထား စိစစ်ခြင်း

Authorization header တွင် API သော့ကို ထည့်သွင်းပါ။

API Key

ယာယီအီးမေးလ်ဖန်တီးခြင်းနှင့် အတည်ပြုကုဒ်ထုတ်ယူခြင်းအတွက်။ အသက်ဝင်နေသော ငွေပေးချေထားသည့် subscription လိုအပ်သည်။

X-API-Key: your_64char_hex_key

Session Cookie

Domain, အီးမေးလ်အကောင့်နှင့် DNS စီမံခန့်ခွဲမှု endpoint များအတွက်။ ဝင်ရောက်ပြီးနောက် သတ်မှတ်သည်။

Cookie: evilmail_session=...

ယာယီအီးမေးလ် API သည် ငွေပေးချေထားသည့် plan လိုအပ်သည်

ယာယီအီးမေးလ် API နှင့် regex ထုတ်ယူခြင်း endpoint များသည် အသက်ဝင်နေသော Bronze, Gold သို့မဟုတ် Premium subscription လိုအပ်သည်။ အခမဲ့အကောင့်များသည် web interface ကိုသာ အသုံးပြုနိုင်သည်။

ယာယီ အီးမေးလ်

ငွေပေးချေထားသည့် Plan လိုအပ်သည်

ပြင်ဆင်နိုင်သော TTL ဖြင့် ဖျက်ပစ်နိုင်သော အီးမေးလ်လိပ်စာများ ဖန်တီးပါ။

Create a temporary email address

Request Body

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.

Inbox နှင့် မက်ဆေ့ချ်များ

သင့်ယာယီ inbox သို့မဟုတ် စိတ်ကြိုက် domain များပေါ်ရှိ သင့်ကိုယ်ပိုင်အီးမေးလ်အကောင့်များမှ ဝင်လာသည့်အီးမေးလ်များကို ဖတ်ပါ။ ယာယီ inbox သည် session cookie များကို အသုံးပြုပြီး၊ စိတ်ကြိုက် domain အကောင့်များသည် API key အထောက်အထားစိစစ်ခြင်းကို အသုံးပြုသည်။

Domain စီမံခန့်ခွဲမှု

စိတ်ကြိုက် domain များ စာရင်းသွင်းခြင်း၊ DNS အတည်ပြုခြင်းနှင့် သင့်အီးမေးလ်အခြေခံအဆောက်အအုံ စီမံခန့်ခွဲပါ။ Domain ကန့်သတ်ချက်များသည် သင့် plan အပေါ် မူတည်သည်။

အီးမေးလ် အကောင့်များ

သင့်အတည်ပြုပြီး domain များအောက်တွင် အီးမေးလ်အကောင့်များ ဖန်တီးခြင်း၊ စာရင်းပြခြင်းနှင့် စီမံခန့်ခွဲပါ။ ကျပန်းအသုံးပြုသူအမည်ဖန်တီးခြင်းဖြင့် တစ်ခုချင်းနှင့် အစုလိုက်ဖန်တီးခြင်းကို ပံ့ပိုးသည်။

စမတ် အတည်ပြုကုဒ် ထုတ်ယူခြင်း

API Key

ဝင်လာသည့်အီးမေးလ်များမှ အတည်ပြုကုဒ်များကို အလိုအလျောက် ထုတ်ယူပါ။ အလိုအလျောက်စမ်းသပ်ခြင်း၊ အကောင့်စာရင်းသွင်းလုပ်ငန်းစဉ်များနှင့် CI/CD pipeline များအတွက် အထူးသင့်လျော်သည်။

Extract verification code from the latest email

Parameters

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.

ပံ့ပိုးထားသော ဝန်ဆောင်မှုများ

ဝန်ဆောင်မှု	Endpoint	ကုဒ် ပုံစံ	ပေးပို့သူ 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

အခြားဝန်ဆောင်မှုတစ်ခု လိုအပ်ပါသလား။

သင်ရှာနေသော ဝန်ဆောင်မှုကို အထက်တွင် စာရင်းမပါဝင်ပါက ကျွန်ုပ်တို့ကို အသိပေးပါ။ Developer တုံ့ပြန်ချက်များအပေါ်အခြေခံ၍ ပံ့ပိုးထားသော ချိတ်ဆက်မှုများကို ပုံမှန်တိုးချဲ့ပြီး မည်သည့်အီးမေးလ်အခြေခံ အတည်ပြုဝန်ဆောင်မှုအတွက်မဆို regex pattern အသစ်များ ထည့်ပေးနိုင်သည်။

ကျွန်ုပ်တို့ကို ဆက်သွယ်ရန်

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 မှတ်တမ်းအမျိုးအစားများကို ပံ့ပိုးသည်။ မှတ်တမ်းများသည် ပထဝီအနေအထားအရ ဖြန့်ကျက်ထားသော nameserver ၄ ခုမှတစ်ဆင့် ပျံ့နှံ့သည်။

ကုဒ် နမူနာများ

ယာယီအီးမေးလ်များ ဖန်တီးခြင်း၊ inbox များဖတ်ခြင်းနှင့် အတည်ပြုကုဒ်များ ထုတ်ယူခြင်းအတွက် ပြည့်စုံသော အလုပ်လုပ်နမူနာများ။

ယာယီ အီးမေးလ် Flow

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"

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

နှုန်းကန့်သတ်ချက်များနှင့် Plan များ

Plan ကန့်သတ်ချက်များ

လုပ်ဆောင်ချက်	Free	Bronze	Gold	Premium
စိတ်ကြိုက် Domain များ	1	5	25	999
အီးမေးလ် / Domain	5	999	999	999
ယာယီ အီးမေးလ် API	Web သာ	အပြည့်အဝ	အပြည့်အဝ	အပြည့်အဝ
Regex API	Web သာ	အပြည့်အဝ	အပြည့်အဝ	အပြည့်အဝ
API နှုန်းကန့်သတ်ချက်	100/hr	1,000/hr	5,000/hr	အကန့်အသတ်မဲ့
ယာယီ Session / IP	10	10	10	10

Endpoint နှုန်းကန့်သတ်ချက်များ

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}Plan အခြေခံ

Error ကိုင်တွယ်ခြင်း

Error တုံ့ပြန်မှုအားလုံးတွင် \"error\" ဟုသတ်မှတ်ထားသော status အကွက်၊ လူဖတ်ရလွယ်သော message နှင့် အသုံးပြုသူ၏အကောင့်ဘာသာစကားနှင့်ကိုက်ညီသော ဒေသန္တရ 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

ဒေသန္တရ Error မက်ဆေ့ချ်များ

အသုံးပြုသူ နှစ်သက်ရာ ဘာသာစကားဖြင့် error များ ပြသရန် messageKey အကွက်ကို အသုံးပြုပါ။ ပံ့ပိုးမှု: အင်္ဂလိပ်၊ တူရကီ၊ ရုရှား၊ ယူကရိန်း၊ ပိုလန်၊ ပြင်သစ်၊ ဂျာမန်၊ အဇာဘိုင်ဂျန်၊ ပါရှန်၊ ဖိလစ်ပီနို၊ ဟော်ဆာ၊ အာကန်။

API Explorer

API endpoint များကို သင့် browser မှ တိုက်ရိုက် စမ်းသပ်ပါ။ သင့် API key ကို ထည့်၍ တောင်းဆိုမှုများ ပို့ကာ တိုက်ရိုက်တုံ့ပြန်မှုများ ကြည့်ပါ။

API Explorerv1.0

evilmail.pro

POST

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

API Key

Request Body

domain

ttlMinutes

တုံ့ပြန်မှုကြည့်ရန် တောင်းဆိုမှုတစ်ခု ပို့ပါ

ချိတ်ဆက်ရန် အသင့်ဖြစ်ပြီလား။

သင့် API key ကို dashboard မှ ရယူ၍ တည်ဆောက်စတင်ပါ။ ငွေပေးချေထားသည့် plan တစ်ခုခုဖြင့် အပြည့်အဝ အသုံးပြုခွင့်။

အခမဲ့ စတင်ရန်Plan များ ကြည့်ရန်

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

ဝန်ဆောင်မှု

Endpoint

ကုဒ် ပုံစံ

ပေးပို့သူ 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

/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

စိတ်ကြိုက် Domain များ

999

အီးမေးလ် / Domain

999

ယာယီ အီးမေးလ် API

Web သာ

အပြည့်အဝ

Regex API

Web သာ

အပြည့်အဝ

API နှုန်းကန့်သတ်ချက်

100/hr

1,000/hr

5,000/hr

အကန့်အသတ်မဲ့

ယာယီ Session / 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