Přejít na dokumentaci
API

Vytvoření schránky

Vydá adresu a vrátí token, který ji čte. Všechna pole jsou volitelná, včetně těla.

POSTapi.openemail.uk/temp-mail/inboxes

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

POST /temp-mail/inboxes

Vydá adresu a vrátí token, který ji čte. Všechna pole jsou volitelná, včetně těla.

Bez přihlašovacího údaje

shell
export OE=https://api.openemail.uk

Neposílejte hlavičku Authorization vůbec. Je to jediný zdroj v tomto API, který odpoví i bez ní. Je zaregistrovaný nad kontrolou klíče, místo aby dostal rozsah, protože se tu nabízí adresa pro někoho, kdo žádnou nemá, a žádat nejdřív o klíč by z toho udělalo formulář na sbírání leadů převlečený za nástroj.

Příklad

Prázdné tělo je platné a je to běžný případ: vygenerovaná local-part na doméně vybrané ze společného fondu, zapůjčená na hodinu.

curl
curl -X POST "$OE/temp-mail/inboxes" -H "Content-Type: application/json" \  -d '{ "localPart": "octopus-signup", "ttlMinutes": 120 }'
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": 0,  "messageLimit": 50,  "lastMessageAt": null,  "token": "oe_inbox_kQ8v…"}

201, a jediná odpověď v celém API, která nese token. Uložte si ho dřív, než s adresou uděláte cokoli dalšího.

Vygenerovaná local-part má dvanáct znaků z abecedy bez samohlásek a bez zaměnitelných znaků, takže nemůže nic vyhláskovat a přežije čtení z obrazovky.

Všechno, co se dá odmítnout, se odmítne jmenovitě, místo aby se to upravilo: 422 unknown_domain, invalid_address, reserved_address nebo invalid_parameter pro ttlMinutes mimo rozsah 1 až 1440; 409 address_taken pro už zadanou local-part; 429 too_many_inboxes na stropu vydávání; 503 temp_mail_unavailable na instalaci, která nemá žádnou doménu ve společném fondu.

Parametry

Tělo

domainstring
Jedna z `GET /temp-mail/domains`. Vynechte ji a fond vybere náhodně, místo aby plnil první doménu. Jedna doména, která dostává každou jednorázovou registraci na internetu, si k tomu vyslouží odpovídající reputaci, a tu sdílí každá adresa na ní. Doména, která ve fondu není, se odmítne jmenovitě (422 `unknown_domain`), místo aby se potichu nahradila, protože adresu, o kterou jste žádali, už byste měli zkopírovanou.
localPartstring
Část před @, pokud si ji chcete zvolit: 3 až 32 znaků z písmen, číslic, teček, pomlček a podtržítek, začínající a končící písmenem nebo číslicí. Užší, než dovoluje RFC 5321, protože tento řetězec jde do cesty URL, do hlavičky `To:` a do stránky HTML. `+` je vyloučeno, protože sub-adresování se na vstupu sbaluje, takže `alice+bob` by bylo jméno, na kterém byste ve skutečnosti nebyli k zastižení. Obsazená jména odpovídají 409 `address_taken`, což pokrývá dva případy: drží ji jiný návštěvník (nebo ji držel během posledního týdne, kdy je adresa stále mimo oběh), a vlastník domény ji vytvořil jako skutečnou adresu, což se odmítá pod týmž kódem, protože pošta na ni dojde jemu a nikdy vám. `postmaster` a další rezervované odpovídají 422 `reserved_address`.
ttlMinutesnumber
Jak dlouhá má zápůjčka být, v minutách, od 1 do 1440. Výchozí je 60. Cokoli mimo tento rozsah odpoví 422 `invalid_parameter` se jménem pole, místo aby se to potichu upravilo. Expiraci, o kterou jste požádali, byste už někomu ukázali. Těch 24 hodin se měří od vytvoření, takže každá hodina vzatá dopředu je prodloužení, které se už nedá utratit později: `ttlMinutes: 120` se vrátí s 22 prodlouženími a 1440 se žádným.

Odpověď: temp_inbox, plus token

idstring
Id schránky, `tinb_` a dvacet čtyři hexadecimálních znaků. Jde do cesty každého dalšího volání a není to tajemství. Tajemství je token.
addressstring
Adresa, kterou předáte dál. Pošta adresovaná na `that+anything@` na ni dorazí také, protože sub-adresování se sbalí ještě před dohledáním.
domainstring
Doména ze společného fondu, na které adresa je, vytažená zvlášť, aby ji klient nemusel k zobrazení parsovat z adresy.
createdAtstring
ISO-8601. 24hodinový strop se měří od tohoto okamžiku, ne od posledního prodloužení.
expiresAtstring
ISO-8601. Za tímto okamžikem token okamžitě přestane autentizovat a úklid smaže poštu při svém dalším běhu.
extensionsLeftnumber
Kolikrát ještě `extend` doopravdy koupí čas, s ohledem na oba stropy: 23 prodloužení, která zápůjčka dovolí, a 24 hodin od `createdAt`, za které se nikdy nedostane — podle toho, co nastane dřív. Schránka vytvořená s `ttlMinutes: 1440` hlásí 0, aniž by cokoli utratila. Nula znamená, že by volání odpovědělo 409, a právě podle toho má klient tlačítko zešedivit, místo aby na to přišel stisknutím.
messageCountnumber
Zprávy, které tato schránka PŘIJALA, ne kolik jich je vidět. Když jednu smažete, neklesne: strop počítá příchody, takže mazání uvolní úložiště, ale ne místo.
messageLimitnumber
Strop, posílaný u každé schránky, aby klient mohl říct „plná“, aniž by si natvrdo zapsal naši konstantu.
lastMessageAtstring | null
Kdy naposledy přišla pošta, ISO-8601, nebo null, pokud žádná nepřišla. Pro někoho, kdo čeká dvě minuty, se null na čerstvé schránce čte úplně jinak než na té, která je zticha.
tokenstring
Přihlašovací údaj, v této odpovědi a v žádné jiné. `oe_inbox_` a 43 znaků base64url; řádek ukládá jen klíčovaný hash, takže ho nelze znovu přečíst ani obnovit.

Každá další odpověď o schránce (načtení, prodloužení) je tento objekt bez token.