ドキュメント

エンドポイントは3つだけで、アカウントもありません。覚えることが少ないので、読むことも少なくて済みます。

ここから始める

クイックスタート

4つのコマンドで、動作するメールボックスとメッセージの読み取りを実現します。APIを呼んだことがない場合はここから始めてください。

クイックスタートを見る →

APIリファレンス

パラメータ、例、ステータスコードを含む3つのエンドポイントすべて。契約内容の全体です。

リファレンスを見る →

制限

レート制限、メッセージサイズ、保存期間など、上限があるものすべて。サプライズのない短いページです。

制限事項を見る →

知っておくべき4つのこと

メールボックスは作成されません
「アドレスを作成する」という呼び出しはありません。アドレスはメールが届いた瞬間に存在し、最後のメッセージが期限切れになると存在しなくなります。
アドレスそのものが認証情報です
公開ドメインでは、アドレスを知っている人なら誰でも読めます。サイトからでもAPIからでも同じです。これが許容できない場合は、独自ドメインを使用してください。
すべては期限切れになります
メッセージは到着から5日後に削除されます。すべてのメッセージにexpires_atが含まれるため、自分で計算する必要はありません。
受信専用
メールを送信するエンドポイントはありません。これは意図的な設計で、無認証の無料サービスがスパムの中継地点になるのを防いでいます。

問題が起きたとき

呼び出しの挙動がこのドキュメントと異なる場合、それはドキュメント側の不具合です。報告いただければ修正します。

メールがまったく届かない
まずMXレコードを確認してください。smtp.grabmail.ioのみが設定されている必要があります。以前のプロバイダのMXが残っていると、トラフィックの一部が気づかないうちに奪われます。
APIは404を返します
ドメインがここに向いていないか、メッセージの保持期間が過ぎています。この2つのケースはerrorスラッグで区別されます。
当方からのメールを名乗るものが届く
それは偽装されたものです。ここからメールを送信することはできません — SPFはv=spf1 -all、DMARCはp=rejectに設定されており、世界中のすべての受信サーバーに破棄するよう指示しています。