Resend 호환 이메일 API: 호환성이 보장하지 않는 것들

API 호환성이 실제로 의미하는 것

For email developers, Resend-compatible mail APIs implement the same request and response schemas as the provider they replace. If you use a Resend-compatible API, you can change your base URL and API key in your environment variables and your POST /emails calls will still work. It covers the syntax of the payload, the HTTP status codes, and the structure of the JSON response. It does not cover your sender reputation, your DNS configuration, your IP warm up, or your billing structure.

인시던트 큐를 담당하는 엔지니어로서, 저는 팀들이 "호환성"을 원클릭 마이그레이션이라고 가정하는 것을 보아 왔습니다. 그렇지 않습니다. 인프라가 아니라 인터페이스를 옮기는 것입니다.

인터페이스: 호환성이 다루는 것

제공업체가 Resend와 호환된다고 주장할 때는 보통 핵심 발송 엔드포인트를 그대로 따르는 것입니다. 그래서 다음과 같은 페이로드를 보낼 수 있습니다.

{ "from": "onboarding@example.com", "to": "user@gmail.com", "subject": "Welcome to the App", "html": "<strong>Hello!</strong>" }

API가 호환된다면 서버는 메시지 ID와 함께 200 OK 또는 201 Created를 반환합니다. 이것이 "쉬운" 부분입니다. 연동 로직을 다시 작성하거나 SDK를 바꿀 필요가 없습니다. AI 에이전트를 만드는 팀에게 이런 일관성은 매우 중요합니다. 에이전트가 MCP 서버나 A2A 카드로 이메일을 발송할 때, 부수 효과(이메일 발송)가 실제로 일어났는지 확인하기 위해 예측 가능한 스키마에 의존하기 때문입니다.

인프라: 호환성이 다루지 않는 것

호환성은 HTTP 계층에서 끝납니다. API가 요청을 수락한 이후에 일어나는 모든 일은 제공업체마다 다릅니다.

1. DNS와 도메인 검증

API 키에는 도메인 인증 권한이 담겨 있지 않습니다. URL만 바꾸고 이메일이 인증되기를 기대할 수는 없습니다. 새 제공업체에서 도메인을 다시 검증해야 합니다. 여기에는 DNS에 새 SPF, DKIM, DMARC 레코드를 추가하는 작업이 포함됩니다.

이를 업데이트하는 것을 잊으면 새 제공업체에 사용자를 대신해 발송할 권한이 없기 때문에 이메일이 거부되거나 스팸으로 표시될 가능성이 높습니다. 전환하기 전에 SendHQ 이메일 DNS 확인 도구로 레코드가 제대로 전파되었는지 확인할 수 있습니다.

2. 발신자 평판과 IP 워밍업

평판은 발신 IP와 도메인에 묶여 있습니다. 한 제공업체에서 다른 제공업체로 옮기면 새로운 공유 IP 집합으로 옮겨 가는 경우가 많습니다. 도메인 평판이 훌륭하더라도 새 IP는 "콜드" 상태이거나, 더 나쁘게는 악의적인 발신자와 공유되고 있을 수 있습니다.

제공업체 수락(API가 "OK"라고 응답)은 전달(수신 서버가 메일을 수락)과 다르고, 전달은 다시 받은편지함 도달(메일이 기본 폴더에 도착)과 다릅니다. 호환성은 제공업체 수락만 다룹니다. 전달이나 도달에는 아무 영향이 없습니다.

3. 웹훅과 이벤트 스키마

발송 API는 호환되더라도 웹훅 이벤트(delivered, bounced, complained)는 호환되지 않는 경우가 많습니다. 시스템이 후속 로직을 실행하기 위해 전송 이벤트 추적에 의존한다면 새 제공업체의 웹훅 페이로드를 점검해야 합니다. 한 시스템의 bounce 이벤트가 다른 시스템에서는 hard_bounce일 수 있습니다.

호환성의 비용: 요금의 현실

호환성 덕분에 전체를 다시 작성하는 비용 없이 더 나은 요금을 찾아볼 수 있습니다. 하지만 요금 모델은 제각각입니다. 2026년 9월 데이터 기준입니다.

• Amazon SES: 가장 공격적인 요금입니다. 종량제는 이메일 1,000통당 0.10 USD입니다(Amazon SES 요금). 2026년 7월 21일에 도입된 새 요금제로는 Essentials(1,000통당 0.16 USD), Pro(1,000통당 0.22 USD + 리전당 월 105 USD), Enterprise(1,000통당 0.23 USD + 월 500 USD)가 있습니다.
• Resend: 월 3,000통(일 100통 제한)의 무료 요금제를 제공합니다. Pro 요금제는 월 20 USD에 50,000통이며 초과분은 1,000통당 0.90 USD입니다(Resend 요금).
• Postmark: 월 15 USD에 10,000통이며 초과분은 1,000통당 1.80~1.20 USD입니다(Postmark 요금).
• Mailgun: 월 15 USD에 10,000통이며 초과분은 1,000통당 1.80~1.10 USD입니다(Mailgun 요금).
• SendGrid: 무료 요금제는 이제 60일 체험판이며 Essentials는 월 19.95 USD부터 시작합니다(SendGrid 요금).

감을 잡기 위해 비교하면, 이메일 50,000통을 보내는 비용은 SES 종량제에서 약 5 USD이고 Postmark 요금제에서는 약 66 USD입니다. API 호환성 덕분에 한 달 치 엔지니어링 작업 없이도 이런 비용 최적화가 가능합니다.

안정성과 에이전트를 위한 엔지니어링

특히 AI 에이전트를 사용할 때 이메일을 외부 부수 효과로 다룬다면 실패를 고려해야 합니다. API가 200 OK를 반환했다고 해서 이메일이 사용자에게 도달했다는 뜻은 아닙니다.

멱등성

에이전트가 타임아웃 때문에 요청을 재시도하면 같은 이메일을 두 번 보낼 위험이 있습니다. 이는 좋지 않은 사용자 경험입니다. 헤더에 멱등성 키를 사용하세요. 그러면 같은 요청이 두 번 전송되어도 제공업체는 이메일을 한 번만 발송합니다.

승인 워크플로

에이전트에게 발송 할당량에 대한 무제한 접근 권한을 주어서는 안 됩니다. 대량 발송에는 승인 계층을 구현하세요. 에이전트가 발송하는 이메일을 위한 간단한 체크리스트는 다음과 같습니다.

1. 스키마 검증: 페이로드가 호환 API 사양과 일치하나요?
2. 속도 제한: 에이전트가 일일 한도(예: Resend 무료 요금제의 일 100통)를 초과하고 있지 않나요?
3. 멱등성: 이 특정 트랜잭션에 고유한 키가 있나요?
4. 휴먼 인 더 루프: 이 이메일은 API 호출 전에 수동 승인이 필요한가요?

마이그레이션 체크리스트

Resend 호환 제공업체로 옮긴다면 다음 순서를 따라 전달이 무너지는 일을 피하세요.

• DNS 설정: SPF, DKIM, DMARC를 구성하세요. 레코드 누락 여부를 확인하려면 이메일 인증 가이드를 읽으세요.
• 검증: 도구를 사용해 DNS 전파를 확인하세요.
• 워밍업: 대량 발송 시 이전 제공업체에서 새 제공업체로 트래픽을 점진적으로 옮기세요. 한 시간 안에 트래픽의 100%를 옮기지 마세요.
• 웹훅 감사: 새 제공업체의 이벤트 유형을 내부 데이터베이스 스키마에 매핑하세요.
• 오류 처리: 새 제공업체가 유효하지 않은 이메일을 처리하는 방식을 테스트하세요. 400을 반환하나요, 아니면 나중에 반송 이벤트가 발생하는 202를 반환하나요?

트레이드오프 요약

항목 | 호환성이 다루는가? | 필요한 조치

요청 페이로드 | 예 | 없음(사양이 일치하는 경우)

응답 형식 | 예 | 없음(사양이 일치하는 경우)

도메인 인증 | 아니요 | DNS 레코드 업데이트

IP 평판 | 아니요 | 워밍업 기간

요금/할당량 | 아니요 | 제공업체 요금 페이지 검토

웹훅 이벤트 | 아니요 | 이벤트 리스너 업데이트

호환성은 민첩성을 위한 도구이지 전달성을 해결해 주는 마법이 아닙니다. 인터페이스와 인프라를 분리하면 특정 업체의 생태계에 갇히지 않고 비용과 성능을 최적화할 수 있습니다.

이런 인프라를 단순하게 만들어 주는 개인정보 최소화, 에이전트 대응 이메일 API가 필요하다면 SendHQ를 살펴보세요.