受信トレイを作成する
アドレスを発行し、それを読むためのトークンを返します。ボディを含め、すべてのフィールドは任意です。
実際の呼び出しを、ご自身のキーで自分のワークスペースに対して実行します。
POST /temp-mail/inboxes
アドレスを発行し、それを読むためのトークンを返します。ボディを含め、すべてのフィールドは任意です。
資格情報は不要
export OE=https://api.openemail.ukAuthorization ヘッダーはまったく送りません。これは API 全体で唯一、それなしで応答するリソースです。スコープを与えるのではなくキーの検査より上に登録されています。ここで提供しているのはアドレスを持っていない人のためのアドレスであり、先にキーを求めれば、ツールの皮をかぶったリード獲得フォームになってしまうからです。
例
空のボディは有効で、それが一般的な使い方です。プールから選ばれたドメイン上に生成されたローカルパートが、1 時間のリースで発行されます。
curl -X POST "$OE/temp-mail/inboxes" -H "Content-Type: application/json" \ -d '{ "localPart": "octopus-signup", "ttlMinutes": 120 }'{ "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": 0, "messageLimit": 50, "lastMessageAt": null, "token": "oe_inbox_kQ8v…"}201 を返します。API 全体で token を含む唯一のレスポンスです。アドレスに対して何かをする前に、まずこれを保存してください。
生成されるローカルパートは、母音と紛らわしい文字を含まないアルファベットから取った 12 文字です。何かの語になることはなく、画面から読み上げても壊れません。
拒否されうるものは、調整されるのではなくすべて名前付きで拒否されます。422 unknown_domain、invalid_address、reserved_address、1 から 1440 の範囲外の ttlMinutes には invalid_parameter。すでに使われているローカルパートには 409 address_taken。発行の上限に達したら 429 too_many_inboxes。プールされたドメインが 1 つもないインストールでは 503 temp_mail_unavailable。
パラメータ
ボディ
domainstring- `GET /temp-mail/domains` のいずれか。省略すると、最初のドメインから埋めるのではなくプールからランダムに選ばれます。インターネット中の使い捨てサインアップを 1 つのドメインで受ければ、それ相応の評判が付き、その評判はそのドメイン上のすべてのアドレスで共有されます。プールにないドメインは、黙って差し替えられるのではなく名前付きで拒否されます（422 `unknown_domain`）。そうでなければ、要求したアドレスをすでにコピーしてしまっているはずだからです。
localPartstring- @ より前の部分を自分で選びたい場合に指定します。英字、数字、ドット、ダッシュ、アンダースコアで 3 から 32 文字、先頭と末尾は英字か数字です。RFC 5321 が許す範囲より狭いのは、この文字列が URL のパス、`To:` ヘッダー、HTML のページに入るからです。`+` は除外しています。サブアドレスは受け入れ時に畳まれるので、`alice+bob` は実際には受信できない名前になってしまうからです。すでに使われている名前は 409 `address_taken` を返し、これは 2 つのケースを含みます。別の訪問者が保持している（またはこの 1 週間以内に保持しており、アドレスがまだ流通から外れている）場合と、ドメインの所有者がそれを実在のアドレスとして作成している場合です。後者が同じコードで拒否されるのは、そこへのメールが所有者に届き、あなたには決して届かないからです。`postmaster` などの予約済みのものは 422 `reserved_address` を返します。
ttlMinutesnumber- リースの長さを分で指定します。1 から 1440 で、既定は 60 です。その範囲外の値は黙って調整されるのではなく、該当フィールドを示して 422 `invalid_parameter` を返します。要求した有効期限を、すでに誰かに見せてしまっているはずだからです。24 時間は作成時点から計られるので、最初に取った 1 時間は、後で使えない延長 1 回分です。`ttlMinutes: 120` は 22 回、1440 は 0 回の延長回数とともに返ります。
レスポンス: temp_inbox とトークン
idstring- 受信トレイの id で、`tinb_` と 24 文字の 16 進数です。他のすべての呼び出しのパスに入り、秘密ではありません。秘密なのはトークンのほうです。
addressstring- 相手に渡すアドレスです。サブアドレスは検索の前に畳まれるので、`that+anything@` 宛てのメールもここに届きます。
domainstring- アドレスが載っているプールされたドメインです。クライアントが表示のためにアドレスを解析しなくて済むよう、切り出してあります。
createdAtstring- ISO-8601 です。24 時間の上限は、最後の延長時点ではなくここから計られます。
expiresAtstring- ISO-8601 です。これを過ぎるとトークンは即座に認証を受け付けなくなり、掃除処理が次回の実行でメールを削除します。
extensionsLeftnumber- `extend` が実際にあと何回時間を買えるかを、2 つの上限の両方を数えて返します。1 つのリースに許された 23 回の延長と、`createdAt` から 24 時間という決して超えられない上限のうち、先に達するほうです。`ttlMinutes: 1440` で作成した受信トレイは、1 回も使っていなくても 0 を報告します。0 はその呼び出しが 409 を返すという意味であり、クライアントは押して確かめるのではなく、それを見てボタンをグレーアウトすべきです。
messageCountnumber- この受信トレイが受け入れたメッセージ数であり、今表示されている数ではありません。1 通削除しても減りません。上限は到着数を数えるので、削除は保存領域を空けても枠は空けません。
messageLimitnumber- 上限です。クライアントが定数をハードコードせずに「満杯」と言えるよう、すべての受信トレイに付いて返ります。
lastMessageAtstring | null- 最後にメールが届いた時刻（ISO-8601）。まだ届いていなければ null です。2 分待っている人にとって、作りたての受信トレイの null は、静かなだけの受信トレイとはまったく違う意味に読めます。
tokenstring- 資格情報で、このレスポンスにだけ載ります。`oe_inbox_` と 43 文字の base64url です。行には鍵付きハッシュしか保存されないので、読み返すことも復元することもできません。
他のすべての受信トレイのレスポンス（取得、延長）は、token を除いたこのオブジェクトです。