API
未実装
省かずに列挙します。
足りないもの
未リリース試して初めて分かるより、あらかじめ伝えるほうがましです。以下はいずれも今日時点では存在しません。
- 配信は最大 5 回試行されます。まず即時、その後 1 分後、5 分後、25 分後、2 時間後です。すべての試行が記録され、
GET /webhooks/{id}/deliveriesから読めます。各行にはattemptとmaxAttemptsが入ります。繰り返しても無意味だと応答が示した場合、再試行は早期に打ち切られます。408、425、429、5xx 以外はすべて意図的な拒否とみなされます。再送用のエンドポイントは依然としてないので、その時間枠より長く落ちていたエンドポイントには欠落が生じます。その欠落は配信ログで見つけられます。 - バウンスしたメッセージも
GET /emails上ではsentのままです。配信レポートは元のメッセージに突き合わされてスレッド上に表示されますが、送信行には何も書き戻されず、その status にバウンス状態はありません。そこから生じるサプレッションは実際に機能します。ハードバウンスや苦情があると、そのアドレスはこのワークスペースのサプレッションリストに載り、次の送信は拒否されます。学習しないのは送信レコードのほうです。 - 汎用のリクエストレートリミッターはありません。カウントされる上限は 2 つあり、どちらも 429 を返します。プランに含まれる月間送信量を使い切ったワークスペースは、翌月 1 日まで以降のすべての送信で
send_quota_exceededを受け取ります。使い捨て受信トレイの発行はクライアントごとに 1 時間 6 件、1 日 30 件に制限され、too_many_inboxesになります。どちらもRetry-Afterを返しません。通常の読み書きのレートに対するリミッターは、約束ではなく不在であり、いずれ是正されます。 - API に添付ファイルのアップロード用エンドポイントはありません。インライン添付は base64 で、メッセージ全体で 5 MB が上限です。それより大きいファイルは、ワークスペースに既にあるファイルを指す
{ fileId }として送信し、ダウンロードリンクとして届きます。受信メールからの添付ファイルの読み取りは動作します。