Postafiók létrehozása

Kérés törzse

domainstring

A `GET /temp-mail/domains` egyik eleme. Ha kihagyod, a pool véletlenszerűen választ, nem pedig az első domaint tölti meg. Az a domain, amely az internet összes eldobható regisztrációját fogadja, ennek megfelelő reputációt szerez, és ezen a reputáción osztozik a rajta lévő minden cím. A poolban nem szereplő domaint nevesítve utasítjuk el (422 `unknown_domain`), nem pedig csendben helyettesítjük, mert a kért címet addigra már kimásoltad.

localPartstring

A @ előtti rész, ha te akarod megválasztani: 3–32 karakter betűkből, számjegyekből, pontokból, kötőjelekből és aláhúzásjelekből, betűvel vagy számjeggyel kezdve és végezve. Szűkebb, mint amit az RFC 5321 megenged, mert ez a szöveg URL-útvonalba, `To:` fejlécbe és HTML-oldalra kerül. A `+` ki van zárva, mivel az alcímzést beérkezéskor összevonjuk, így az `alice+bob` olyan név volna, amelyen valójában nem lehetne elérni téged. A foglalt nevek 409 `address_taken` választ adnak, ami két esetet fed le: egy másik látogatónál van (vagy az elmúlt héten volt, amíg a cím még nincs újra forgalomban), illetve a domain tulajdonosa valódi címként létrehozta, amit ugyanezzel a kóddal utasítunk el, mert az oda érkező levél hozzá jut el, nem hozzád. A `postmaster` és a többi fenntartott név 422 `reserved_address` választ ad.

ttlMinutesnumber

Milyen hosszú legyen a bérlet, percben, 1 és 1440 között. Alapértelmezése 60. Az ezen a tartományon kívüli érték 422 `invalid_parameter` választ kap a mező megnevezésével, nem pedig csendes igazítást. A kért lejáratot addigra valószínűleg már megmutattad valakinek. A 24 órát a létrehozástól mérjük, így minden előre felvett óra egy olyan hosszabbítás, amelyet később nem lehet elkölteni: a `ttlMinutes: 120` esetén 22 marad, az 1440 esetén egy sem.

idstring

A postafiók azonosítója, `tinb_` és huszonnégy hexadecimális karakter. Minden más hívás útvonalában szerepel, és nem titok. A token az.

addressstring

Az átadandó cím. A `that+anything@` címre küldött levél is elér ide, mert az alcímzést a keresés előtt összevonjuk.

domainstring

A pool-domain, amelyen a cím van, külön kiemelve, hogy a kliensnek ne kelljen a címet szétbontania a megjelenítéshez.

createdAtstring

ISO-8601. A 24 órás korlátot ettől mérjük, nem az utolsó hosszabbítástól.

expiresAtstring

ISO-8601. Ezen túl a token azonnal megszűnik hitelesíteni, a takarítás pedig a következő futásakor törli a leveleket.

extensionsLeftnumber

Hányszor vásárol még ténylegesen időt az `extend`, mindkét korlátot figyelembe véve: a bérlet által engedett 23 hosszabbítást, és a `createdAt` időponttól számított 24 órát, amelyen soha nem léphet túl – amelyiket előbb eléri. A `ttlMinutes: 1440` értékkel létrehozott postafiók 0-t jelent úgy, hogy semmit nem költött el. A nulla azt jelenti, hogy a hívás 409-cel válaszolna, és a kliensnek ezen kellene letiltania a gombot, nem pedig megnyomással felfedeznie.

messageCountnumber

Hány üzenetet FOGADOTT EL ez a postafiók, nem pedig hány látszik belőle. Nem csökken, ha törölsz egyet: a korlát a beérkezéseket számolja, így a törlés tárhelyet szabadít fel, helyet nem.

messageLimitnumber

A korlát, amelyet minden postafiókválaszon elküldünk, hogy a kliens a mi konstansunk beégetése nélkül írhassa ki, hogy „megtelt”.

lastMessageAtstring | null

Mikor érkezett utoljára levél, ISO-8601 szerint, vagy null, ha még egy sem. Annak, aki két perce vár, a friss postafiókon látott null egészen mást jelent, mint egy csendes postafiókon.

tokenstring

A hitelesítő adat, ezen a válaszon és máshol sehol. `oe_inbox_` és 43 base64url karakter; a sor csak egy kulcsolt hasht tárol, így nem olvasható újra és nem állítható helyre.