ドキュメント
エンドポイントは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に設定されており、世界中のすべての受信サーバーに破棄するよう指示しています。