API 문서
MailPass API를 사용하여 이메일 서비스를 통합하세요.
Base URL
https://www.mailpass.im/api/v1
인증
모든 API 요청은 Authorization 헤더에 API 키를 포함해야 합니다.
Authorization: Bearer YOUR_API_KEYAPI 키는 설정 > API 키에서 생성할 수 있습니다.
OTP API
이메일 인증 코드 발송 및 검증을 위한 API
POST /otp/send
POST /otp/verify
구독자 API
구독자 및 리스트 관리를 위한 API
POST /subscribers
GET /subscribers
캠페인 API
이메일 캠페인 생성 및 발송을 위한 API
POST /campaigns
POST /campaigns/:id/send
Mail Send API
트랜잭셔널 이메일 발송을 위한 API (단건/배치)
POST /mail/send
POST /mail/send-batch
웹훅
이벤트 알림을 받기 위한 웹훅 설정
email.opened
email.clicked
바운스 API
이메일 바운스 처리 및 조회를 위한 API
POST /bounces
GET /bounces
응답 형식
모든 API 응답은 JSON 형식으로 반환됩니다.
성공 응답
{
"success": true,
"data": { ... }
}오류 응답
{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "The email field is required."
}
}Rate Limits
API 요청은 분당 60회로 제한됩니다. Rate limit 초과 시 429 상태 코드가 반환됩니다.