Ugrás a dokumentációra
API

Postafiók lekérése

A bérlet, az üzenetek száma és a hátralévő hosszabbítások. Az az állapot, amelyet a kliens a lista köré rajzol.

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

A valódi hívást futtatja le a munkaterületén, a saját kulcsával.

GET /temp-mail/inboxes/{id}

A bérlet, az üzenetek száma és a hátralévő hosszabbítások. Az az állapot, amelyet a kliens a lista köré rajzol.

A postafiók tokenje

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

Az alábbi minden hívás azt a tokent viszi, amelyet a POST /temp-mail/inboxes adott vissza, ugyanabban az Authorization: Bearer fejlécben, amelyet egy API-kulcs is használ. Maga a cím semmire nem jogosít, és ez az elkülönítés a funkció lényege, nem formalitás: az eldobható címet abban a pillanatban adod annak, akit karnyújtásnyira tartasz magadtól, amikor kiállítják.

Az útvonalban szereplő id-nek ugyanazt a postafiókot kell megneveznie, mint a tokennek. A token önmagában is azonosít egyet, tehát ez nadrágszíj és nadrágtartó együtt, de azt jelenti, hogy aki két postafiókot összekever, 404-et kap ahelyett, hogy csendben más levelét olvasná.

Példa

Olcsó: egyetlen indexelt sor, objektumtárolás nélkül. Ha levelet akarsz, inkább az üzenetlistát pollozd. Az a hívás a lejáratot is viszi.

curl
curl "$OE/temp-mail/inboxes/tinb_9c2f41ab7d3e4c118a0f5d72" -H "$INBOX"
Válasz
{  "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"}

A lejárt, megsemmisített és ismeretlen postafiókra egy válasz jár: 404 Not Found. A „lejárt a bérleted”, a „ez nem a tiéd” és a „ez sosem létezett” kívülről szándékosan megkülönböztethetetlen, és a postafiók ugyanezért nem hajlandó különbséget tenni köztük.