ドキュメント
エンドポイントは3つだけで、アカウントもありません。覚えることが少ないので、読むことも少なくて済みます。
ここから始める
クイックスタート
4つのコマンドで、動作するメールボックスとメッセージの読み取りを実現します。APIを呼んだことがない場合はここから始めてください。
APIリファレンス
パラメータ、例、ステータスコードを含む3つのエンドポイントすべて。契約内容の全体です。
制限
レート制限、メッセージサイズ、保存期間など、上限があるものすべて。サプライズのない短いページです。
ガイド
もう少し長い手順解説で、失敗のパターンまで扱います。パラメータの意味ではなく、実際に何をすべきかです。
受信箱の保存期間
5日という期限が何に適用され、何に適用されないのか、時計が実際にいつ動き出すのか、メッセージに付随して消えるすべてのもの、APIから期限をそのまま読み取る方法、そしてそのどれもが問題でなくなる習慣まで。
捨てメアドとは
定義、仕組み（MXレコード1本と、最初のメールが届いた瞬間に生まれる受信箱）、捨てメアドと使い捨て・バーナー・エイリアスの違い、向いている用途、使ってはいけない4つの場面、アドレスの寿命。
Playwrightでのメールテスト
テストごとに新しい受信箱を開くfixture、リトライ回数ではなく実時間の期限で待つ方法、自分のテンプレートに固定した抽出処理、3つの完全なフロー（コード、マジックリンク、パスワードリセット）、シークレットなしでCIを通す方法。
知っておくべき4つのこと
- メールボックスは作成されません
- 「アドレスを作成する」という呼び出しはありません。アドレスはメールが届いた瞬間に存在し、最後のメッセージが期限切れになると存在しなくなります。
- アドレスそのものが認証情報です
- 公開ドメインでは、アドレスを知っている人なら誰でも読めます。サイトからでもAPIからでも同じです。これが許容できない場合は、独自ドメインを使用してください。
- すべては期限切れになります
- メッセージは到着から5日後に削除されます。すべてのメッセージに
expires_atが含まれるため、自分で計算する必要はありません。 - 受信専用
- メールを送信するエンドポイントはありません。これは意図的な設計で、無認証の無料サービスがスパムの中継地点になるのを防いでいます。
問題が起きたとき
呼び出しの挙動がこのドキュメントと異なる場合、それはドキュメント側の不具合です。報告いただければ修正します。
- メールがまったく届かない
- まずMXレコードを確認してください。
smtp.grabmail.ioのみが設定されている必要があります。以前のプロバイダのMXが残っていると、トラフィックの一部が気づかないうちに奪われます。 - APIは404を返します
- ドメインがここに向いていないか、メッセージの保持期間が過ぎています。この2つのケースは
errorスラッグで区別されます。 - 当方からのメールを名乗るものが届く
- それは偽装されたものです。ここからメールを送信することはできません — SPFは
v=spf1 -all、DMARCはp=rejectに設定されており、世界中のすべての受信サーバーに破棄するよう指示しています。