Přejít na dokumentaci
API

Prodloužení zápůjčky

Další hodina k expiraci, až po den, na který je zápůjčka omezena. Bez těla.

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

Spustí skutečné volání proti vašemu pracovnímu prostoru, s vaším vlastním klíčem.

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

Další hodina k expiraci, až po den, na který je zápůjčka omezena. Bez těla.

Token schránky

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

Každé volání níže nese token, který vrátilo POST /temp-mail/inboxes, ve stejné hlavičce Authorization: Bearer, jakou používá API klíč. Samotná adresa neopravňuje k ničemu a toto oddělení je smyslem celé funkce, ne formalitou: jednorázová adresa se v okamžiku vydání předává straně, kterou si držíte od těla.

Id v cestě musí označovat tutéž schránku jako token. Schránku identifikuje už samotný token, takže jde o dvojitou pojistku, ale díky ní dostane volající, který si popletl dvě schránky, 404 místo toho, aby si tiše četl cizí poštu.

Příklad

Hodina se přičítá k expiresAt, ne k aktuálnímu času, takže prodloužení ve chvíli, kdy na hodinách ještě čas zbývá, o tento čas nepřijde.

curl
curl -X POST "$OE/temp-mail/inboxes/tinb_9c2f41ab7d3e4c118a0f5d72/extend" -H "$INBOX"
Odpověď
{  "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"}

Dvacet tři prodloužení, a nová expirace je navíc omezena na 24 hodin po createdAt, takže poslední prodloužení může přinést méně než celou hodinu a zápůjčka vytvořená až na stropu žádné nemá. extensionsLeft už započítává oba stropy; čtěte ho a expiresAt zpět, místo abyste si počítali vlastní volání.

Na stropu odpoví 409 conflict_error / extension_limit. Tím to končí: vezměte si novou adresu, nebo skutečnou schránku, která nevyprší.