SendGrid の API を利用して curl でメールを送る方法

単純に、API Key を取得して curl で送るだけ、というのをやってみます。なお、SendGrid へのアカウントの登録は済んでいるものとします。

手順の概要

API Key を生成（取得）する
API Key を含んだ、POST 用の JSON ファイルを作成する
上記の JSON を POST する

具体的手順

1. API Key を生成（取得）する

設定画面内の API Key のページに行って API Key を生成します。以下のヘルプページに従えばよいです。

APIキーを管理する - ドキュメント | SendGrid

2. API Key を含んだ、POST 用の JSON ファイルを作成する

たとえば、以下のような JSON ファイルを作ります。ファイル名は、my_sendgrid.js とでもします。

 {
   "personalizations": [
     {
       "to": [
         {
           "email": "送り先の人の名前@hogehoge.com"
         }
       ],
       "subject": "こんにちは！"
     }
   ],
   "from": {
     "email": "わたしの名前@foobar.com"
   },
   "content": [
     {
       "type": "text/plain",
       "value": "テキストメールです！"
     }
   ]
 }

3. 上記の JSON を curl で POST する

上記で作成した my_sendgrid.js を curl で POST します。curl で -d オプションを用いる際にその対象がファイルの場合は、先頭にアットマーク @ をつければよいです。

 $ curl -X POST https://api.sendgrid.com/v3/mail/send -d @my_sendgrid.js -H "Authorization: Bearer ここに取得したAPI Keyが入る" -H "Content-Type: application/json"