メッセージの一覧
届いたものを新しい順に、メタデータのみで返します。ポーリングすべき呼び出しはこれです。
実際の呼び出しを、ご自身のキーで自分のワークスペースに対して実行します。
GET /temp-mail/inboxes/{id}/messages
届いたものを新しい順に、メタデータのみで返します。ポーリングすべき呼び出しはこれです。
受信箱トークン
export OE=https://api.openemail.ukexport INBOX="Authorization: Bearer oe_inbox_kQ8v…"以下のすべての呼び出しは、POST /temp-mail/inboxes が返したトークンを、API キーと同じ Authorization: Bearer ヘッダーに載せて送ります。アドレス自体は何も認可しません。この分離は形式ではなく、この機能の要点です。使い捨てアドレスは、発行されたその瞬間に、距離を置いておきたい相手へ渡されるものだからです。
パスの id は、トークンが指すのと同じ受信箱を指していなければなりません。受信箱はトークンだけで特定できるので二重の備えですが、これにより二つの受信箱を取り違えた呼び出し側は、誤ったメールを黙って読むのではなく 404 を受け取ります。
例
一覧が描画するものはすべて、インデックス付きの 1 テーブル上のカラムであり、保存された本文は一切読みません。limit は 1 から 50 で省略可能です。リースも同じレスポンスに載るので、ポーリングする側はいつ止めるべきかを知るために 2 回目の呼び出しをする必要がありません。
curl "$OE/temp-mail/inboxes/tinb_9c2f41ab7d3e4c118a0f5d72/messages?limit=25" -H "$INBOX"{ "object": "list", "data": [ { "object": "temp_message", "id": "tmail_4b81c07d2fa9418e93c6a13f", "from": { "name": "Acme", "email": "[email protected]" }, "to": "[email protected]", "subject": "Confirm your email", "snippet": "Your code is 481923…", "spam": false, "seen": false, "attachmentCount": 0, "sizeBytes": 8241, "receivedAt": "2026-09-01T10:31:04.000Z" } ], "expiresAt": "2026-09-01T12:00:00.000Z"}snippet は本文をテキストにした先頭 400 文字で、たいていの場合はその受信箱が存在する理由そのものです。確認コードはふつう、何も開かずに見えます。
spam は共通のヒューリスティックが下した判断です。それはフラグ以上のものではありません。何も振り分けられず、移動も抑制もされておらず、メッセージはどちらであれこの一覧に載ります。
seen はメッセージが取得されたときに反転し、一覧に載ったときではありません。このエンドポイントをポーリングしても、何も既読にはなりません。