Izveidot iesūtni
Izdod adresi un atgriež marķieri, kas to lasa. Visi lauki ir neobligāti, arī pieprasījuma ķermenis.
Izpilda īstu izsaukumu pret jūsu darbvietu, ar jūsu paša atslēgu.
POST /temp-mail/inboxes
Izdod adresi un atgriež marķieri, kas to lasa. Visi lauki ir neobligāti, arī pieprasījuma ķermenis.
Bez akreditācijas datiem
export OE=https://api.openemail.ukNesūtiet nekādu Authorization galveni. Šis ir vienīgais API resurss, kas atbild bez tās. Tas ir reģistrēts pirms atslēgas pārbaudes, nevis apveltīts ar tvērumu, jo piedāvātais ir adrese tam, kam tādas nav, un prasīt vispirms atslēgu padarītu to par potenciālo klientu formu rīka drēbēs.
Piemērs
Tukšs ķermenis ir derīgs un ir parastais gadījums: ģenerēta lokālā daļa uz domēna, kas izvēlēts no pūla, ar nomu uz stundu.
curl -X POST "$OE/temp-mail/inboxes" -H "Content-Type: application/json" \ -d '{ "localPart": "octopus-signup", "ttlMinutes": 120 }'{ "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, un vienīgā atbilde visā API, kas nes token. Saglabājiet to, pirms darāt ar adresi jebko citu.
Ģenerēta lokālā daļa ir divpadsmit rakstzīmes no alfabēta bez patskaņiem un bez līdzīga izskata zīmēm, tāpēc tā nevar neko izburtot un izdzīvo nolasīšanu no ekrāna.
Viss, ko var atteikt, tiek atteikts, nosaucot iemeslu, nevis pielāgots: 422 unknown_domain, invalid_address, reserved_address vai invalid_parameter, ja ttlMinutes ir ārpus 1 līdz 1440; 409 address_taken, ja lokālā daļa jau aizņemta; 429 too_many_inboxes pie izdošanas griestiem; 503 temp_mail_unavailable instalācijā, kurai vispār nav koplietojama domēna.
Parametri
Ķermenis
domainstring- Viens no `GET /temp-mail/domains`. Izlaidiet to, un pūls izvēlas nejauši, nevis piepilda pirmo domēnu. Viens domēns, kas saņem katru vienreizlietojamo reģistrēšanos internetā, nopelna atbilstošu reputāciju, un šo reputāciju dala katra adrese uz tā. Domēns, kas nav pūlā, tiek atteikts ar nosauktu iemeslu (422 `unknown_domain`), nevis klusi aizstāts, jo jūs jau būtu nokopējis prasīto adresi.
localPartstring- Daļa pirms @, ja vēlaties to izvēlēties: 3 līdz 32 rakstzīmes no burtiem, cipariem, punktiem, defisēm un pasvītrojumiem, sākot un beidzot ar burtu vai ciparu. Šaurāk, nekā atļauj RFC 5321, jo šī virkne nonāk URL ceļā, `To:` galvenē un HTML lapā. `+` ir izslēgts, jo apakšadresēšana tiek sakļauta ienākot, tāpēc `alice+bob` būtu vārds, ar kuru jūs patiesībā nevarētu sasniegt. Aizņemti vārdi atbild ar 409 `address_taken`, kas aptver divus gadījumus: tas pieder citam apmeklētājam (vai piederēja pēdējās nedēļas laikā, kamēr adrese vēl ir ārpus aprites), un domēna īpašnieks to ir izveidojis kā īstu adresi, kas tiek atteikts ar to pašu kodu, jo pasts uz to nonāk pie viņa un nekad pie jums. `postmaster` un pārējie rezervētie atbild ar 422 `reserved_address`.
ttlMinutesnumber- Cik ilgai jābūt nomai minūtēs, no 1 līdz 1440. Pēc noklusējuma 60. Jebkas ārpus šī diapazona atbild ar 422 `invalid_parameter`, nosaucot lauku, nevis tiek klusi pielāgots. Jūs jau būtu kādam parādījis prasīto derīguma termiņu. 24 stundas tiek mērītas no izveides, tāpēc katra uzreiz paņemtā stunda ir pagarinājums, ko vēlāk vairs nevarēs iztērēt: `ttlMinutes: 120` atgriežas ar 22 no tiem, bet 1440 — bez neviena.
Atbilde: temp_inbox plus marķieris
idstring- Iesūtnes id, `tinb_` un divdesmit četras heksadecimālas rakstzīmes. Tas nonāk katra cita izsaukuma ceļā, un tas nav noslēpums. Noslēpums ir marķieris.
addressstring- Nododamā adrese. Pasts, kas adresēts uz `that+anything@`, arī to sasniedz, jo apakšadresēšana tiek sakļauta pirms meklēšanas.
domainstring- Koplietojamais domēns, uz kura atrodas adrese, izdalīts atsevišķi, lai klientam tā parādīšanai nebūtu jāparsē adrese.
createdAtstring- ISO-8601. 24 stundu ierobežojums tiek mērīts no šī brīža, nevis no pēdējā pagarinājuma.
expiresAtstring- ISO-8601. Pēc tā marķieris uzreiz pārstāj autentificēt, un tīrīšana nākamajā reizē dzēš pastu.
extensionsLeftnumber- Cik reižu `extend` patiešām vēl nopirks laiku, ņemot vērā abus griestus: 23 pagarinājumus, ko pieļauj noma, un 24 stundas no `createdAt`, kuras tā nekad nevar pārsniegt, — to, kurš sasniegts pirmais. Iesūtne, kas izveidota ar `ttlMinutes: 1440`, ziņo 0, neko neiztērējusi. Nulle nozīmē, ka izsaukums atbildētu ar 409, un tieši pēc tā klientam vajadzētu padarīt pogu neaktīvu, nevis uzzināt to, nospiežot.
messageCountnumber- Ziņojumi, ko šī iesūtne ir PIEŅĒMUSI, nevis cik tiek rādīti. Skaitlis nesamazinās, kad kādu izdzēšat: griesti skaita pienākušos, tāpēc dzēšana atbrīvo krātuvi, bet ne vietu iesūtnē.
messageLimitnumber- Griesti, sūtīti katrā iesūtnes atbildē, lai klients varētu pateikt „pilna“, mūsu konstanti neiekodējot.
lastMessageAtstring | null- Kad pēdējoreiz pienāca pasts, ISO-8601, vai null, ja nekas nav pienācis. Null svaigā iesūtnē cilvēkam, kurš gaidījis divas minūtes, nozīmē pavisam ko citu nekā klusa iesūtne.
tokenstring- Akreditācijas dati, šajā atbildē un nekur citur. `oe_inbox_` un 43 base64url rakstzīmes; rinda glabā tikai atslēgotu jaucējvērtību, tāpēc tos nevar ne pārlasīt, ne atgūt.
Katra cita iesūtnes atbilde (iegūšana, pagarināšana) ir šis pats objekts bez token.