소개
EvilMail의 REST API를 사용하면 일회용 이메일 기능을 모든 애플리케이션에 통합할 수 있습니다. 메일박스 생성부터 메시지 조회까지 모든 것을 프로그래밍 방식으로 제어할 수 있습니다.
인증
모든 API 요청에는 Bearer 토큰이 필요합니다. 대시보드의 "API 설정" 섹션에서 API 키를 생성하세요.
curl -H "Authorization: Bearer YOUR_API_KEY"
https://api.evilmail.com/v1/mailboxes주요 엔드포인트
메일박스 관리
# 메일박스 생성
curl -X POST https://api.evilmail.com/v1/mailboxes
-H "Authorization: Bearer YOUR_API_KEY"
-H "Content-Type: application/json"
-d '{"domain": "evilmail.com", "prefix": "test-user"}'
# 메일박스 목록 조회
curl https://api.evilmail.com/v1/mailboxes
-H "Authorization: Bearer YOUR_API_KEY"
# 메일박스 삭제
curl -X DELETE https://api.evilmail.com/v1/mailboxes/{id}
-H "Authorization: Bearer YOUR_API_KEY"메시지 작업
# 메시지 목록 조회
curl https://api.evilmail.com/v1/mailboxes/{id}/messages
-H "Authorization: Bearer YOUR_API_KEY"
# 메시지 상세 조회
curl https://api.evilmail.com/v1/messages/{message_id}
-H "Authorization: Bearer YOUR_API_KEY"
# 첨부 파일 다운로드
curl https://api.evilmail.com/v1/messages/{message_id}/attachments/{attachment_id}
-H "Authorization: Bearer YOUR_API_KEY" -o attachment.pdf응답 형식
모든 응답은 JSON 형식으로 반환됩니다. 성공 시 상태 코드는 200(조회), 201(생성), 204(삭제)입니다.
{
"id": "mb_abc123",
"address": "[email protected]",
"created_at": "2026-01-15T10:30:00Z",
"expires_at": "2026-01-16T10:30:00Z",
"message_count": 3
}에러 핸들링
오류 발생 시 적절한 HTTP 상태 코드와 에러 메시지가 반환됩니다:
- 401 Unauthorized — API 키가 유효하지 않거나 누락됨
- 404 Not Found — 리소스가 존재하지 않음
- 429 Too Many Requests — 레이트 리밋 초과
- 500 Internal Server Error — 서버 내부 오류
Webhook 설정
새 이메일을 실시간으로 수신하려면 Webhook을 설정합니다. 대시보드 또는 API에서 Webhook URL을 등록하면 이메일 수신 시 POST 요청이 전송됩니다.
curl -X POST https://api.evilmail.com/v1/webhooks
-H "Authorization: Bearer YOUR_API_KEY"
-H "Content-Type: application/json"
-d '{"url": "https://your-app.com/webhook/email", "events": ["message.received"]}'결론
EvilMail API는 RESTful 설계에 기반한 간결하고 강력한 인터페이스를 제공합니다. 인증, 메일박스 관리, 메시지 작업, Webhook을 활용하여 애플리케이션에 일회용 이메일 기능을 원활하게 통합하세요.
이전DNS 레코드 완전 해설: A, MX, CNAME, TXT 그리고 그 너머다음Thunderbird, Outlook, Apple Mail을 POP3/IMAP으로 EvilMail에 연결하는 방법