API

Načtení schránky

Zápůjčka, počet zpráv a zbývající prodloužení. Stav, který klient vykresluje kolem seznamu.

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

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

GET /temp-mail/inboxes/{id}

Zápůjčka, počet zpráv a zbývající prodloužení. Stav, který klient vykresluje kolem seznamu.

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

Levné: jeden indexovaný řádek a žádné objektové úložiště. Pokud chcete poštu, dotazujte se místo toho na seznam zpráv. To volání nese i expiraci.

curl

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

Vypršelá, zničená i neznámá schránka mají jedinou odpověď: 404. „Vaše zápůjčka vypršela“, „tohle není vaše“ a „tohle nikdy neexistovalo“ jsou zvenčí záměrně nerozlišitelné a schránka je ze stejného důvodu odmítá rozlišovat.