Node.js

1. SDK をインストールします。

   npm install @spacepost/node

2. API キーをエクスポートします。

   export SPACEPOST_API_KEY="sp_live_YOUR_API_KEY"

3. メールを送信します。

   send.ts

   import { SpacePost } from "@spacepost/node";
   
   const spacepost = new SpacePost(); // reads SPACEPOST_API_KEY
   
   const { data, error } = await spacepost.emails.send({
     from: "Acme <hello@acme.com>",
     to: ["user@example.com"],
     subject: "Welcome to Acme",
     html: "<h1>Welcome</h1><p>Glad to have you.</p>",
     text: "Welcome. Glad to have you.",
     tags: [{ name: "category", value: "welcome" }],
   });
   
   if (error) {
     console.error(error.statusCode, error.name, error.message);
     process.exit(1);
   }
   console.log("Email id:", data.id);

   node send.ts（Node 22.6 以降は型を取り除いて実行します）または npx tsx send.ts で実行します。

SDK は API エラーで例外をスローしません。呼び出しのたびに error を確認してください。グローバルの fetch を使うため、Node 18 以降で動作します。

ノート

すでに公式の Resend SDK を使っていますか？ そのまま使い続けられます。RESEND_BASE_URL=https://api.spacepost.dev を設定し、SpacePost のキーを使ってください。詳しくは Resend からの移行をご覧ください。

詳細は Node.js SDK リファレンスをご覧ください。