API

リースを延長する

有効期限を 1 時間延長します。リースの上限日までです。ボディはありません。

POSTapi.openemail.uk/temp-mail/inboxes/{id}/extend

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

POST /temp-mail/inboxes/{id}/extend

有効期限を 1 時間延長します。リースの上限日までです。ボディはありません。

受信箱トークン

shell

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

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

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

例

1 時間は現在時刻ではなく expiresAt に加算されるため、まだ時間が残っているうちに延長しても、その残り時間は失われません。

curl

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

レスポンス

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

延長は 23 回までで、新しい有効期限は createdAt の 24 時間後にも丸められます。そのため最後の 1 回は 1 時間に満たないことがあり、上限の時点で作られたリースには延長の余地がまったくありません。extensionsLeft はすでに両方の上限を織り込んでいます。自分で呼び出し回数を数えるのではなく、これと expiresAt を読み返してください。

上限に達すると 409 conflict_error / extension_limit を返します。そこで終わりです。新しいアドレスを取るか、期限の切れない本物のメールボックスを使ってください。