技術解説 · 出典付きの回答

SendGridのサンドボックスモードとは？

SendGridのサンドボックスモードは、実際の受信者にメールを送らずにAPI連携やSMTPの設定をテストできる、制限された環境です。このモードでは、システムはリクエストを検証して成功レスポンスを返しますが、開発中に誤ってスパムを送ったり悪用されたりしないよう、実際のメールは宛先アドレスに配信されません。

サンドボックスモードの仕組み

アカウントがサンドボックスモードのとき、SendGridは受信したAPI呼び出しやSMTPリクエストを処理し、ペイロードの構文が正しいことと認証が有効であることを確認します。APIはリクエストを受信したことを示す202 Acceptedのステータスコードを返します。しかし、メール転送エージェントはメッセージを外部のインターネットにリレーしません。これにより、開発者は送信者レピュテーションを危険にさらしたり費用を発生させたりすることなく、コードのロジックとエラー処理を確認できます。

確認の要件

サンドボックスモードから抜けるには、確認のプロセスを完了する必要があります。通常は、アカウントの詳細情報を提出し、送信者IDを検証します。SendGridは、プラットフォームが悪意のある目的に使われるリスクを軽減するため、このステップを必須としています。アカウントが完全に承認されるまでは、未検証のアドレスへメールを送ろうとしても、APIが成功レスポンスを返すにもかかわらずメッセージは破棄されます。

テストの進め方

開発者は、アプリケーションとSendGrid APIとの連携をテストするためにサンドボックスモードを使うべきです。APIのレスポンスが成功していることを確認したら、次のステップとして単一の送信元メールアドレスまたはドメイン全体を検証します。本番環境に移行する前にSendHQの無料ツールを使ってDNSレコードが正しく設定されていることを確認すれば、配信の失敗を避けられます。

本番環境への移行

本番環境に移行するには、アカウントの有効化プロセスを完了し、ドメイン認証を設定する必要があります。具体的には、送信ドメインのDNS設定にSPFレコードとDKIMレコードを追加します。アカウントのステータスがサンドボックスからアクティブに変わると、メールは実際の受信者にルーティングされるようになります。ユーザーリスト全体への配信を始める前に、既知の社内アドレスで最終テストを行ってください。

よく寄せられる質問

202レスポンスが返ってくるのにメールが届かないのはなぜですか？

これはサンドボックスモードの想定どおりの動作です。202ステータスはAPIリクエストが有効だったことを意味しますが、アカウントがまだ制限されているため、メールは配信されていません。

サンドボックスモードを無効にするにはどうすればよいですか？

アカウントの確認プロセスを完了し、求められた事業情報をSendGridのチームに提出して承認を受ける必要があります。

サンドボックスモードで自分のメールアドレスに送信できますか？

一般的にはできません。そのメールアドレスが送信者として個別に検証されているか、検証済みのIDに含まれていない限り、サンドボックスモードではすべてのアドレスへの配信がブロックされます。

サンドボックスモードに費用はかかりますか？

いいえ。実際のメールは配信されないため、サンドボックスモードで行ったリクエストは毎月の送信クォータにカウントされません。

一次情報源

さらに学ぶ

SendGrid APIAPIでメールを送信メールのドメイン検証メールAPIの料金SendGridの代替サービス