Apidog

올인원 협업 API 개발 플랫폼

API 설계

API 문서

API 디버깅

API 모킹

API 자동화 테스트

Postmark API와 Node.js로 이메일 보내기

Postmark의 사용자 친화적인 API로 이메일 커뮤니케이션을 간소화하고, 메시지가 스팸 폴더가 아닌 받은 편지함에 도착하도록 하세요. 상세한 분석으로 귀중한 통찰력을 얻고, 원활한 Node.js 통합으로 개발을 간소화하세요. 오늘 이메일 마케팅을 강화하세요!

Young-jae

Young-jae

Updated on December 20, 2024

즉각적인 메시징과 소셜 미디어의 시대에 이메일의 힘을 과소평가하기 쉽습니다. 그러나 이메일은 비즈니스와 개인 모두에게 중요한 커뮤니케이션 채널로 남아 있습니다. 이는 브랜드 참여를 촉진하고, 중요한 업데이트를 전달하며, 개인화된 상호작용을 촉진합니다. 그럼에도 불구하고 이메일의 효과는 한 가지 중요한 요소, 즉 배달 가능성에 의존합니다. 전통적인 이메일 발송 방식은 종종 스팸 필터와 낮은 받은 편지함 비율로 어려움을 겪어 메시지가 디지털 심연에 방치되곤 합니다.

여기서 Postmark가 등장합니다. 개발자 친화적인 트랜잭션 이메일 API 서비스인 Postmark는 자신 있게 이메일을 보낼 수 있도록 도와줍니다. 이는 프로세스를 간소화하여 귀하의 메시지가 의도된 수신자에게 도달하도록 보장하며 이메일 성과에 대한 귀중한 통찰력을 제공합니다.

Postmark란 무엇인가요?

Postmark클라우드 기반 트랜잭션 이메일 API 서비스입니다. 이는 완전히 온라인으로 운영되며, 자체 이메일 서버나 소프트웨어를 관리할 필요가 없음을 의미합니다. 주요 용어를 설명하자면:

클라우드 기반: Postmark의 인프라는 원격 서버에 있으며, 인터넷을 통해 접근할 수 있습니다. 귀하의 컴퓨터에 소프트웨어를 설치하거나 유지할 필요가 없습니다.

트랜잭션 이메일: 트랜잭션 이메일은 귀하의 웹사이트나 애플리케이션에서 사용자가 취하는 행동에 따라 전송되는 이메일입니다. Postmark는 애플리케이션 내 특정 사용자 행동에 의해 트리거되는 이메일에 중점을 둡니다. 이러한 이메일은 일반적으로 1:1 개인화된 메시지로, 예를 들면:

  • 비밀번호 재설정 확인서
  • 주문 확인 및 영수증
  • 계정 확인 이메일
  • 알림 이메일 (예: 보안 알림, 약속 알림)

API 서비스: API는 애플리케이션 프로그래밍 인터페이스의 약어입니다. 이는 귀하의 애플리케이션이 Postmark와 통신할 수 있도록 하는 도구 및 지침의 집합입니다. Postmark API를 사용하면 약간의 코드로 Node.js 애플리케이션에 이메일 발송 기능을 쉽게 통합할 수 있습니다.

왜 Postmark를 선택해야 하나요?

본질적으로, Postmark는 개발자와 기업을 위해 이메일 발송을 간소화하고 효율화합니다:

  • 트랜잭션 이메일 발송 시, 웹메일이나 본인 서버와 같은 전통적인 방법은 번거롭고 신뢰할 수 없습니다. 바로 여기서 Postmark가 빛납니다. 이러한 방법에 비해 수많은 장점을 제공합니다:
  • 향상된 배달 가능성: 이는 Postmark의 가장 큰 강점이라고 할 수 있습니다. 전통적인 이메일 발송 방법은 종종 스팸 필터와 낮은 받은 편지함 비율로 어려움을 겪습니다. Postmark는 다음의 긍정적인 요인 덕분에 업계 최고의 배달 가능성을 자랑합니다:
  • 고급 라우팅 기법: Postmark는 이메일을 배달 가능성을 최적화한 네트워크를 통해 지능적으로 라우팅합니다.
  • 평판 관리: Postmark는 이메일 제공자와 함께 깨끗한 평판을 유지하여 귀하의 이메일이 스팸으로 표시될 가능성을 줄입니다.

상세한 분석: 영향을 모른 채 이메일을 보내던 시대는 지났습니다. Postmark는 귀하의 이메일 성과에 대한 포괄적인 보고서와 통찰력을 제공합니다. 열림 비율, 클릭률, 및 반송률과 같은 메트릭을 추적할 수 있습니다.

이러한 분석은 귀하가 이메일 콘텐츠를 최적화하고, 참여를 개선하며, 해결이 필요한 배달 문제를 식별할 수 있도록 합니다.

간소화된 개발: 애플리케이션에 이메일 기능을 통합하는 것은 전통적인 방법으로는 골칫거리가 될 수 있습니다. Postmark의 사용자 친화적인 API는 이 과정을 수월하게 만들어 줍니다. 몇 줄의 코드만 있으면 Postmark의 강력한 이메일 발송 기능을 애플리케이션 내에서 활용할 수 있습니다. 이는 개발자가 이메일 복잡성에 얽매이지 않고 핵심 기능에 집중할 수 있도록 합니다.

향상된 보안: 사용자 데이터를 다룰 때 보안은 가장 중요합니다. Postmark는 귀하와 수신자의 정보를 보호하기 위해 강력한 보안 조치를 취하여 데이터 보안을 최우선으로 합니다. 그들은 귀하의 데이터가 안전하게 유지되도록 산업 표준과 규정을 준수합니다.

요약하자면, Postmark는 신뢰할 수 있고 안전하며 데이터 기반으로 트랜잭션 이메일을 발송해야 하는 기업과 개발자에게 매력적인 패키지를 제공합니다. 그것은 프로세스를 간소화하고, 배달 가능성을 증가시키며, 이메일 마케팅 노력을 최적화하기 위한 귀중한 통찰력을 제공합니다.

오랜 이야기 그만하고, Postmark API 및 Node.js로 이메일 발송을 시작해 봅시다!

Postmark API 및 Node.js로 이메일 발송하기

전제 조건: Postmark API 키에 대하여

계속 진행하기 전에 이미 Postmark 계정을 보유하고 있는 것이 중요합니다. 이 글을 작성하는 시점에서 안타깝게도 Postmark는 Google, Yahoo 또는 기타 공공 도메인을 사용하여 계정을 생성하는 것을 허용하지 않습니다. 즉, MUST 도메인 이름을 사용하여 계정을 생성해야 합니다. 예를 들어 sam@samuelblog.com . 그러므로 계정을 생성하고 도메인을 확인하며 API 키를 얻어야 합니다. 이 키가 이메일 발송에 필요합니다.

계정을 생성하면 테스트 모드로 시작됩니다. 그런 다음 모든 서비스를 이용하기 위해 승인을 요청해야 합니다.

우리는 또 API를 테스트할 도구가 필요합니다. 응답과 상태가 무엇인지 알아야 합니다. 이를 위해 Apidog라는 API 테스트 도구를 사용하여 이 설정을 테스트하겠습니다.

Apidog는 설계, 디버깅, 문서화, 테스트 및 모킹을 처리하는 API 개발을 위한 올인원 도구입니다.
Apidog의 홈페이지 이미지
버튼

계정을 생성하면 자동 프로젝트 폴더가 할당됩니다. 이곳에서 다양한 API를 테스트할 수 있습니다. 이 문서를 참조하여 Apidog 및 그 작업을 학습하세요.

코드 작성하기

이미 Node.js 애플리케이션에서 작업하고 있다면, npm을 사용하여 postmark Node.js SDK를 설치해야 합니다: npm install postmark --save 이렇게 하면 패키지가 설치됩니다.

작업 디렉토리가 아직 없다면 mkdir를 사용하여 생성하세요. 이제 npm init -y를 실행하여 npm을 초기화합니다. 이를 완료한 후, npm install express postmark --save를 실행하고 가장 좋아하는 코드 편집기 - 대부분의 경우 vsCode에서 해당 폴더를 엽니다.

이제 index.js 또는 server.js 파일을 생성합니다. 이 파일은 postmark API를 사용하여 이메일을 보내는 모든 코드 로직을 담게 됩니다.

server.js 파일을 열고 아래 코드를 붙여넣습니다;

const express = require("express");

const app = express();
app.disable("x-powered-by"); // express 서버 숨기기.
app.use(express.json());

app.post("/send-email", (req, res) => {
  res.send("이메일 전송 엔드포인트에 도달했습니다!");
});

app.listen(8080, () => {
  console.log(`백엔드 서버가 8080 포트에서 대기 중입니다.`);
});

위의 코드는 간단한 node.js 설정입니다. 저장하고 node server.js를 사용하여 node.js 서버를 시작합니다.

생성한 경로를 테스트해야 하며, 이를 위해 Apidog를 사용하겠습니다. 브라우저나 컴퓨터에서 앱을 열고 새 프로젝트를 클릭하여 새 프로젝트를 생성하거나 귀하에게 할당된 기본 프로젝트를 클릭합니다.

Apidog 프로젝트 페이지

생성한 프로젝트를 클릭하거나 할당된 프로젝트를 클릭한 후 "새 요청" 버튼을 눌러 첫 번째 요청을 보냅니다.

Apidog에서 입력 필드에 경로를 입력하고 "실행"을 클릭하여 응답을 확인합니다.

Apidog 응답 페이지

본문의 응답이 우리가 정의한 경로에서 보낸 응답과 일치하는 것을 볼 수 있습니다. 이는 애플리케이션이 작동 중임을 나타내며 이제 이메일을 전송해야 합니다!

다음으로 server.js 파일을 열고 코드베이스를 다음으로 업데이트합니다;

const express = require("express");
const postmark = require("postmark");

const app = express();
app.disable("x-powered-by"); // express 서버 숨기기.
app.use(express.json());

const client = new postmark.ServerClient(
  "acXXXXXXX_XXX" // .env 파일을 사용할 수 있습니다.
);

app.post("/send-email", async (req, res) => {

  try {
    await client.sendEmail({
      From: "iroro@yourdomain.com",
      To: "test@blackhole.postmarkapp.com",
      Subject: "Postmark에서 인사 드립니다",
      HtmlBody: "<strong>안녕하세요</strong> 친애하는 Postmark 사용자.",
      TextBody: "Postmark에서 인사 드립니다!",
      MessageStream: "outbound",
    });
    res.send("이메일이 성공적으로 발송되었습니다!");
  } catch (error) {
    console.error("이메일 전송 중 오류 발생:", error);
    res.status(500).send("이메일 전송 중 오류 발생"); // 오류 응답 처리
  }
});

app.listen(8080, () => {
  console.log(`백엔드 서버가 8080 포트에서 대기 중입니다.`);
});

코드가 Postmark SDK로 업데이트되었습니다. 요청을 Postmark에 보내 API 키를 확인하고 있습니다. 또한 try catch를 사용하여 오류가 발생하면 오류를 기록하고 오류의 출처를 확인합니다.

이 코드를 가지고 있다면 파일을 저장하고 node 서버를 재시작하세요. 그 후, Apidog로 돌아가 /send-email 엔드포인트로 새 요청을 보냅니다.

모든 것이 잘 되었다면, Node.js 애플리케이션에서 Postmark API를 사용하여 이메일을 보낼 수 있어야 합니다!

이것이 작동했는지 확인하기 위해 로그를 보거나 이메일을 받은 수신자를 확인하세요. 귀하의 계정이 확인되었다면 잘 작동할 것입니다.

Postmark 이메일 로그

Postmark API 발송 한도

Postmark는 모든 사용자에게 원활하고 신뢰할 수 있는 이메일 배달을 우선시합니다. 그들은 브로드캐스트 이메일에 대해 엄격한 일일 발송 한도를 부과하지 않지만, 책임 있는 발송 관행을 보장하기 위한 조치를 마련하고 있습니다. 요약은 다음과 같습니다:

배치 발송:

  • 최대 메시지: 배치 엔드포인트를 사용하여 단일 API 호출로 최대 500개의 이메일을 보낼 수 있습니다.
  • 페이로드 크기: 첨부 파일을 포함한 총 페이로드 크기는 API 호출당 50MB를 초과할 수 없습니다.

브로드캐스트 메시지 스트림:

  • 평판에 중점을 둡니다: 일일 한도와 달리 Postmark는 두 가지 주요 메트릭을 기반으로 귀하의 브로드캐스트 메시지 스트림의 건강을 모니터링합니다:
  • 스팸 불만 비율: 경고를 피하기 위해 스팸 불만 비율을 0.1% 이하로 유지해야 합니다.
  • 반송률: 최적의 배달을 보장하기 위해 반송률을 10% 이하로 유지해야 합니다.

모니터링 및 경고:

  • 색상 코드 표시기: Postmark는 계정 내에서 색상 코딩 시스템을 사용하여 브로드캐스트 메시지 스트림의 건강을 시각적으로 나타냅니다:
  • 주황색: 스팸 불만 비율 또는 반송률이 한계에 접근하고 있습니다.
  • 빨간색: 스팸 불만 비율 또는 반송률이 한계를 초과했습니다. 이는 발송 능력에 영향을 미칠 수 있습니다.

최적 발송을 위한 모범 사례:

  • 발송 분산: 하루 동안 이메일을 분산 발송하는 것이 일반적으로 한꺼번에 큰 양을 발송하는 것보다 선호됩니다.
  • 발송량 모니터링: 일일 및 시간별 이메일 발송량을 추적하세요. 큰 증가가 예상되는 경우 Postmark 지원팀에 연락하여 필요 사항을 논의하세요.
  • 이메일 최적화: 적절한 이메일 형식을 보장하고 스팸 같은 콘텐츠를 피하세요. 높은 반송률이나 스팸 불만은 계정 건강에 영향을 미칠 수 있습니다.

이 지침을 따르고 책임 있는 발송 관행을 유지함으로써 Postmark의 이메일 API를 최대한 활용하고 이메일이 의도한 수신자에게 도달하게 할 수 있습니다.

결론

결론적으로, Postmark API와 Node.js는 이메일을 보내기 위한 강력하고 사용자 친화적인 솔루션을 제공합니다. 배달 가능성, 통찰력 있는 분석 및 간소화된 개발에 중점을 두어 Postmark는 이메일 커뮤니케이션을 간소화하고 메시지가 의도한 청중에게 도달하도록 보장합니다. 오늘 Postmark를 탐색하고 신뢰할 수 있고 효과적인 이메일 발송의 잠재력을 잠금 해제하세요.

코딩 즐기세요!

EXAONE 3.0 7.8B 모델을 로컬에서 실행하는 방법튜토리얼

EXAONE 3.0 7.8B 모델을 로컬에서 실행하는 방법

이 글에서는 EXAONE 3.0 7.8B 모델을 자신의 컴퓨터에서 설치하고 실행하는 방법을 단계별로 상세히 알아보겠습니다

Young-jae

March 25, 2025

Claude 3.7 소넷 API에 접근하고 Apidog을 사용하여 테스트하는 방법튜토리얼

Claude 3.7 소넷 API에 접근하고 Apidog을 사용하여 테스트하는 방법

Anthropic의 최신 출시인 Claude 3.7 Sonnet에 대해 기대하고 있으며, Apidog로 테스트하면서 API를 통한 기능을 탐색하고 싶다면, 올바른 장소에 오신 것입니다. 💡시작하기 전에 간단한 팁을 드리겠습니다: 오늘 Apidog를 무료로 다운로드하여 API 테스트 프로세스를 간소화하세요. 특히 Claude 3.7 Sonnet의 강력한 기능을 탐색하는 데 적합한 도구로, 최첨단 AI 모델을 테스트하려는 개발자에게 이상적입니다!버튼 Claude 3.7 Sonnet이 중요한 이유로 시작해봅시다. Anthropic은 최근 2025년 2월 24일에 이 모델을 공개했으며, 즉시 및 단계별 응답을 위한 하이브리드 추론 기능을 갖춘 가장 지능적인 창작물로 자리 잡았습니다. 이는 코딩, 추론 등 여러 부분에서 혁신적인 변화를 가져오며, 현재 e Anthropic API, Amazon Bedrock, Google Cloud의 Vertex AI를 통해 사용할 수 있습니다. 이 튜

Young-jae

February 25, 2025

GitHub Copilot 무료: 어떻게 시작하나요?튜토리얼

GitHub Copilot 무료: 어떻게 시작하나요?

GitHub Copilot 무료 사용법을 알아보세요. 이 AI 기반 코딩 도우미에 대한 이 가이드는 VS Code와 JetBrains와 같은 인기 IDE의 설정 단계를 다루며, 무료로 스마트한 코드 제안 및 완성을 통해 생산성을 높일 수 있도록 도와줍니다!

Young-jae

December 19, 2024