개발자 문서

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

세션 쿠키

도메인, 이메일 계정, 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 관리

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"로 설정된 status 필드, 사람이 읽을 수 있는 메시지, 사용자의 계정 언어에 맞는 지역화된 오류 메시지를 위한 선택적 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 탐색기

브라우저에서 직접 API 엔드포인트를 테스트하세요. API 키를 입력하고 요청을 보내 실시간 응답을 확인하세요.

API 탐색기v1.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