Ugrás a dokumentációra
API

A bérlet meghosszabbítása

Még egy óra a lejáratra, annak a napnak a határáig, amelynél a bérlet meg van szabva. Törzs nélkül.

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

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

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

Még egy óra a lejáratra, annak a napnak a határáig, amelynél a bérlet meg van szabva. Törzs nélkül.

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

Az óra az expiresAt értékhez adódik hozzá, nem a mostani időponthoz, így a még hátralévő idővel való hosszabbítás megtartja azt az időt.

curl
curl -X POST "$OE/temp-mail/inboxes/tinb_9c2f41ab7d3e4c118a0f5d72/extend" -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-01T13:00:00.000Z",  "extensionsLeft": 21,  "messageCount": 3,  "messageLimit": 50,  "lastMessageAt": "2026-09-01T10:31:04.000Z"}

Huszonhárom hosszabbítás, és az új lejárat a createdAt utáni 24 órához is hozzá van vágva, így az utolsó kevesebbet hozhat egy teljes óránál, a határon létrehozott bérletnek pedig egyáltalán nincs hosszabbítása. Az extensionsLeft már mindkét plafont beleszámolja; ezt és az expiresAt értéket olvasd vissza ahelyett, hogy a saját hívásaidat számolnád.

A határon 409 conflict_error / extension_limit a válasz. Ezzel vége: végy új címet, vagy egy igazi postafiókot, amely nem jár le.