blastengine（ブラストエンジン）はシンプルに使える開発者向けメールサービスを提供しています。何かと面倒なメール配信をシンプルに、かつ確実に送信先に届くようになります。

現在、Node.js向けに、blastengine SDKを開発しています。この記事では、その使い方を解説します。まずはテキストメールの即時送信についてです。

ユーザ登録する

blastengineにユーザ登録します。管理画面に入るためのユーザID、パスワードが手に入るので、ログインします（ユーザIDは後で使います）。

送信元ドメインのSPFを設定する

送信元として利用するドメイン（自分で持っているもの）の設定をします。これは任意のドメイン管理サービスで設定できますが、TXTレコードに以下のSPFを追加します。

txt @ v=spf1 include:spf.besender.jp ~all

ログイン後、管理画面の右上にある設定メニューに移動します。

そして設定の中で、APIキーを取得します。

SDKを使う上で必要なのは、先ほどのAPIキーとユーザIDになります。

SDKは npm コマンドでインストールできます。

npm i blastengine

まずSDKをインポートします。

import Blastengine, { Transaction } from 'blastengine';

先ほどのAPIキーとユーザIDを使って初期化します。

new Blastengine(YOUR_USER_ID, YOUR_API_KEY);

メールを即時配信する際にはトランザクションオブジェクトを使います。

const transaction = new Transaction;

続けて、トランザクションオブジェクトに必要なオブジェクトをセットします。

transaction
	.setFrom('info@example.com', 'From Name')
	.setSubject('メールの件名')
	.setTo('to@example.jp')
	.setText('メールの本文');

添付ファイルはファイルへのパスかBlobオブジェクト、またはBufferを適用してください。複数指定可能です。

transaction
	.addAttachment('file.png')
	.addAttachment('another.png')

後は send メソッドで送信できます。これは非同期メソッドです。

const res = await transaction.send();

res.delivery_id に数字が入っていれば、送信完了です。

res.delivery_id
// => 18

コードはGitHubにアップしてあります。ライセンスはMIT Licenseになります。

blastengineには他にも一括メール配信を行う機能があります。ぜひ皆さんのシステム開発におけるメール配信を素早く実装するのに役立ててください。