Resend에서 마이그레이션

호환성 경계

SendHQ는 직접 HTTP 발송에 쓰이는 일반적인 Resend 스타일 JSON 필드를 받아들이지만, Resend SDK를 그대로 대체하는 것은 아닙니다. 자체 서버 측 HTTP 어댑터가 /api/v1/emails를 가리키게 하세요. Resend 호스트가 하드코딩된 SDK를 다시 구성할 수 있다고 가정하지 마세요.

필드 매핑

from, to, cc, bcc, subject, html, text, reply_to와 안전한 사용자 정의 headers는 그대로 매핑됩니다. SendHQ는 message_class, 호스팅 template 참조, draft_id, 답장/스레드 필드도 받아들입니다. Resend 전용 React 페이로드, 인라인 첨부 파일 배열, 태그, 오디언스, 브로드캐스트, 예약 발송 필드는 동등하게 지원되지 않습니다.

첨부 파일과 템플릿

첨부 파일은 SendHQ 초안에 업로드한 다음 draft_id로 발송하세요. 호스팅 템플릿은 게시된 버전과 타입이 지정된 데이터를 가진 SendHQ 리소스입니다. 제공업체의 템플릿 식별자를 복사하지 말고 템플릿 ID와 렌더링 호출을 명시적으로 마이그레이션하세요.

재시도

논리적 발송 하나마다 안정적인 Idempotency-Key 하나를 생성하세요. 그 키와 동일한 JSON 페이로드로 재시도합니다. 제목, 본문, 수신자, 헤더, 템플릿 데이터가 바뀌면 새 키를 사용하세요. 그렇지 않으면 SendHQ가 409를 반환합니다. 저장된 응답을 재생한 경우에는 Idempotent-Replayed: true가 포함됩니다.

전환 체크리스트

1. 사용할 모든 From 도메인과 정확한 발신 주소를 검증합니다.
2. 소유한 받은편지함으로 통제된 텍스트 및 HTML 메시지를 보냅니다.
3. 제공업체 접수를 전송 이벤트와 별도로 확인합니다.
4. 409, 422, 423, 429, 5xx 처리를 시험합니다.
5. 트랜잭션 경로와 라이프사이클 경로가 모두 통과할 때까지 이전 제공업체 어댑터를 유지합니다.