receivemail.dev

receivemail.dev

API を 1 回呼び出すだけで使える、使い捨ての実際に受信可能なメールアドレスです。登録、SMTP の設定、アカウントは不要です。検証コード／OTP メールやサインアップのフローのテストなど、QA テストスイートで実際の受信箱を使わずに済ませたいあらゆる場面を想定して作られています。

公開先は receivemail.dev です。

仕組み

# create a mailbox (default: expires in 15 min)
curl -X POST https://receivemail.dev/mailboxes
# => {"address":"[email protected]","expiresAt":"...","secret":"..."}

# trigger your own app's email to that address, then poll:
curl https://receivemail.dev/mailboxes/[email protected]/messages \
  -H "Authorization: Bearer <secret from above>"
# => {"address":"...","messages":[{"from_address":"...","subject":"...","body_text":"..."}]}

作成時に返される secret が唯一の認証情報です。アカウントやログイン機能はないため、大切に保管してください。@receivemail.dev のどのアドレスでも、明示的に予約されていなくてもメールを受信できます（他の使い捨て受信箱プロバイダーと同じです）。ただし、予約済みのアドレスだけが、受信したメールを読み取るための secret を持ちます。

エンドポイント

エンドポイント	説明
POST /mailboxes	新しいアドレスを作成します。任意のリクエストボディ {"ttlMinutes": 1-60} を指定できます。デフォルトは 15 です。公開されており、トークンは不要です。
GET /mailboxes/:address	メタデータ（作成日時／有効期限）を取得します。メールボックス固有の secret を Bearer トークンとして指定する必要があります。
GET /mailboxes/:address/messages	新しい順に直近 50 件のメッセージを取得します。同じ secret が必要です。
GET /mailboxes/:address/wait?timeout=25&since=<ISO>	ロングポーリング：since より新しい最新のメッセージが届くとすぐに返します。届かなかった場合は、timeout 秒後（最大 25 秒）に {"timed_out":true} を返します。同じ secret が必要です。

制限

• IP ごとのメールボックス作成は 1 分あたり 20 件、全体で 1 日あたり 12,000 件です。
• メールボックスの有効期間は最大 60 分です。短期間のテストフロー向けであり、恒久的な受信箱ではありません。
• メッセージは、メールボックスの有効期限が切れてから 24 時間後に削除されます。

無料で利用でき、メールボックスの作成に API キーは不要です。

アーキテクチャ

完全なサーバーレス構成で、他のものと共有するインフラストラクチャはありません。

• Cloudflare Email Routing が receivemail.dev ゾーンで実際のメールを受信します。
• Cloudflare Worker（src/index.ts）— email() ハンドラーが postal-mime を使って受信メールを解析・保存します。fetch() ハンドラーが REST API とランディングページ（src/landing.ts）を提供します。scheduled() ハンドラーが期限切れのメールボックス、古いメール、レート制限バケットを毎日クリーンアップします。
• D1（schema.sql、schema_v2.sql、schema_v3.sql）— emails、mailboxes（機能ベースの読み取りアクセスに使うメールボックスごとの secret を含む）、rate_limits。

ローカル開発

npm install
npx wrangler dev      # local dev server
npm run deploy        # wrangler deploy

receivemail.dev ゾーンがあり、Email Routing が設定され、wrangler.toml で DB としてバインドされた D1 データベースがある Cloudflare アカウントが必要です。

関連プロジェクト

sms-florin — メールの代わりに SMS／OTP 認証コードを扱う、同じ仕組みのサービスです（英国の実際の電話番号をレンタルします）。