API

受信箱を取得する

リース、メッセージ数、残りの延長回数。クライアントが一覧の周りに描く状態です。

GETapi.openemail.uk/temp-mail/inboxes/{id}

実際の呼び出しを、ご自身のキーで自分のワークスペースに対して実行します。

GET /temp-mail/inboxes/{id}

リース、メッセージ数、残りの延長回数。クライアントが一覧の周りに描く状態です。

受信箱トークン

shell

export OE=https://api.openemail.ukexport INBOX="Authorization: Bearer oe_inbox_kQ8v…"

以下のすべての呼び出しは、POST /temp-mail/inboxes が返したトークンを、API キーと同じ Authorization: Bearer ヘッダーに載せて送ります。アドレス自体は何も認可しません。この分離は形式ではなく、この機能の要点です。使い捨てアドレスは、発行されたその瞬間に、距離を置いておきたい相手へ渡されるものだからです。

パスの id は、トークンが指すのと同じ受信箱を指していなければなりません。受信箱はトークンだけで特定できるので二重の備えですが、これにより二つの受信箱を取り違えた呼び出し側は、誤ったメールを黙って読むのではなく 404 を受け取ります。

例

軽い呼び出しです。インデックス付きの 1 行だけを読み、オブジェクトストレージには触れません。欲しいのがメールそのものなら、代わりにメッセージ一覧をポーリングしてください。そちらの呼び出しは有効期限も一緒に返します。

curl

curl "$OE/temp-mail/inboxes/tinb_9c2f41ab7d3e4c118a0f5d72" -H "$INBOX"

レスポンス

{  "object": "temp_inbox",  "id": "tinb_9c2f41ab7d3e4c118a0f5d72",  "address": "[email protected]",  "domain": "freemailaddress.com",  "createdAt": "2026-09-01T10:00:00.000Z",  "expiresAt": "2026-09-01T12:00:00.000Z",  "extensionsLeft": 22,  "messageCount": 3,  "messageLimit": 50,  "lastMessageAt": "2026-09-01T10:31:04.000Z"}

期限切れ、破棄済み、未知の受信箱は、いずれも同じ 404 です。「リースが切れた」「それはあなたのものではない」「そんなものは存在しなかった」は、外からは意図的に区別できません。メールボックス側も同じ理由で区別を拒みます。