blastengineは手軽に利用できるエンジニア向けのメールサービスを提供しています。何かと面倒なメール配信をシンプルに、かつ確実に送信先に届くようになります。

今回はblastengineでメールを送信するまでの流れを順番に解説します。

ユーザ登録する

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

APIキーをゲットする

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

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

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

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

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

トークンを生成する

APIリクエストするためのトークンを生成します。手順としては次のとおりです。

ユーザIDとAPIキーを連結する
SHA256のハッシュを生成する
ハッシュを全て小文字にする
3の文字列をBASE64エンコードする

例えばユーザIDとAPIキーが以下だったとします。

項目	値
ユーザID	blastengine
APIキー	ABCDEFG

まずユーザIDとAPIキーを連結します。

blastengineABCDEFG

この文字列のハッシュ値を取ります。

$ echo -n "blastengineABCDEFG" | shasum -a 256
1f0eee8fc120676fc589492f15228efb3d021f0aee4b006efb27c7ee33f5d6c9  -

この値をすべて小文字にし、BASE64エンコードします。

$ echo -n "1f0eee8fc120676fc589492f15228efb3d021f0aee4b006efb27c7ee33f5d6c9" | base64 
MWYwZWVlOGZjMTIwNjc2ZmM1ODk0OTJmMTUyMjhlZmIzZDAyMWYwYWVlNGIwMDZlZmIyN2M3ZWUzM2Y1ZDZjOQ==

この生成された MWYwZWVlOGZjMTIwNjc2ZmM1ODk0OTJmMTUyMjhlZmIzZDAyMWYwYWVlNGIwMDZlZmIyN2M3ZWUzM2Y1ZDZjOQ== がトークンになります。

JSONを用意する

APIにリクエストするためのJSONを用意します。今回は簡単な例として、次のJSONになります。JSONキーについては別な記事で解説する予定ですが、おそらく見ればどこに用いられるものなのかはすぐ分かるかと思います。fromのemail、toのメールアドレスは必要なものに書き換えてください。

{
  "from": {
    "email": "no-reply@example.jp",
    "name": "送信者サンプル"
  },
  "to": "test@example.com",
  "subject": "テスト件名",
  "encode": "ISO-2022-JP",
  "text_part": "テスト配信",
  "html_part": "<!DOCTYPE html><html><header></header><body>__code1__ sample html</body></html>"
}

リクエストを組み立てる

blastengineの即時配信（トランザクション）用のエンドポイントは以下になります。

POST https://app.engn.jp/api/v1/deliveries/transaction

トークンとJSONの準備ができたらcurlリクエストを組み立てます。

$ curl -XPOST \
  -H "Authorization: Bearer MWYwZWVlOGZjMTIwNjc2ZmM1ODk0OTJmMTUyMjhlZmIzZDAyMWYwYWVlNGIwMDZlZmIyN2M3ZWUzM2Y1ZDZjOQ==" \
	-H "Content-Type: application/json" \
	-d '{
			"from": {
				"email": "no-reply@example.jp",
    			"name": "送信者サンプル"
  			},
  			"to": "test@example.com",
  			"subject": "テスト件名",
  			"encode": "ISO-2022-JP",
  			"text_part": "テスト配信",
  			"html_part": "<!DOCTYPE html><html><header></header><body>sample html</body></html>"
	}' \
	https://app.engn.jp/api/v1/deliveries/transaction

これで {"delivery_id":4} といったレスポンスが返ってくれば完成です。

まとめ

blastengineは次の3ステップでメール送信できます。

SPFレコードをセットする
APIキーをゲットしてトークンを生成する
APIを実行する

日本で提供しているサービスだけあって、日本のキャリアやユーザへの到達率も高いのが特徴です。ぜひblastengineをお試しください！

エンジニア向けメール配信システム「ブラストエンジン」