SMTP で送信する

SMTP サーバー経由でメールを送るものなら何でも、OpenEmail 経由で送信できます。フレームワークのメーラー、CMS、監視ツール、プリンターなどです。ユーザー名 openemail と、パスワードとしての API キーでサインインします。キーには emails:send スコープが必要で、キーが渡すメッセージは、そのキーで行う POST /emails と同じ送信です。

メッセージを message.eml として保存し、curl で渡します。From は、キーが送信元にできるアドレスでなければなりません。

From: Acme <[email protected]>To: [email protected]Subject: Hello over SMTPMessage-ID: <[email protected]> It works.

curl --url "smtps://smtp.openemail.uk:465" \  --user "openemail:$OPENEMAIL_API_KEY" \  --mail-from "[email protected]" \  --mail-rcpt "[email protected]" \  --upload-file message.eml --crlf

curl --ssl-reqd --url "smtp://smtp.openemail.uk:587" \  --user "openemail:$OPENEMAIL_API_KEY" \  --mail-from "[email protected]" \  --mail-rcpt "[email protected]" \  --upload-file message.eml --crlf

受け付けられたメッセージへの応答は 250 2.0.0 OK queued as で、その後にメッセージの id が続きます。この id は GET /emails/{id} が受け取るものと同じなので、メッセージ、そのイベント、トラッキングは、他の送信と同じように読み取れます。

メッセージは読み取られ、REST の送信と同じ経路で送られます。そのため、バイト単位でそのまま渡されるのではなく、各パートから組み立て直されます。

経路は 1 つなので、REST の送信に適用されるものは、すべてここでも適用されます。

• —キーのスコープと、キーが制限されているアドレスとドメイン。
• —送信者の確認: From は、送信できるドメインのアドレスであり、キーが送信元にできるアドレスである必要があります。
• —ワークスペースの送信枠と配信停止リスト。
• —送信元アドレスの署名と、開封とクリックのトラッキング。signature も tracking も指定しない REST の送信と同じです。
• —レーン: 一斉送信レーンが一時停止している間、X-OpenEmail-Stream: broadcast の付いたメッセージは拒否されます。
• —Webhook と配信イベント。どちらも 250 の応答にある id でメッセージを示します。

Message-ID のあるメッセージは 1 回だけ送信されます。同じ受信者に対して同じ Message-ID をもう一度渡すと、最初のメッセージの id が返り、何も送信されません。そのため、接続が切れた後に再試行するソフトウェアが 2 回送ることはありません。同じメッセージでも受信者が異なれば、別の送信になります。「冪等性」を参照してください。

キーが渡したメッセージはすべて、そのキーのリクエストログの 1 行になります。メソッドは SMTP、パスは /emails で、ステータスは REST の送信であれば返っていたものです。キューに入った場合は 202、拒否された場合は同じエラー code とともに 403、422、429 のいずれかになります。GET /keys/{id}/requests?path=/emails は、これらを REST の送信と並べて一覧にします。実在するキーでサインインに失敗した場合は、そのキーのアクティビティに表示されます。