API

Iznīcināt iesūtni

Dzēš pastu tagad, negaidot nomas beigas.

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

Izpilda īstu izsaukumu pret jūsu darbvietu, ar jūsu paša atslēgu.

DELETE /temp-mail/inboxes/{id}

Dzēš pastu tagad, negaidot nomas beigas.

Iesūtnes marķieris

shell

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

Katrs zemāk minētais izsaukums nes marķieri, ko atgrieza POST /temp-mail/inboxes, tajā pašā Authorization: Bearer galvenē, ko izmanto API atslēga. Pati adrese neko neautorizē, un šī nošķiršana ir funkcijas jēga, nevis formalitāte: vienreizlietojama adrese izdošanas brīdī tiek iedota tieši tai pusei, ko turat izstieptas rokas attālumā.

Ceļā norādītajam id jānosauc tā pati iesūtne, ko nosauc marķieris. Marķieris pats par sevi iesūtni identificē, tāpēc šī ir dubulta drošība, taču tas nozīmē, ka izsaucējs, kas sajaucis divas iesūtnes, saņem 404, nevis klusi lasa nepareizo pastu.

Piemērs

Ziņojumi un to saglabātie pamatteksti pazūd nekavējoties, un marķieris pārstāj autentificēt jau nākamajā pieprasījumā.

curl

curl -X DELETE "$OE/temp-mail/inboxes/tinb_9c2f41ab7d3e4c118a0f5d72" -H "$INBOX"

Atbilde

{ "object": "temp_inbox", "id": "tinb_9c2f41ab7d3e4c118a0f5d72", "destroyed": true }

Servera pusē nekas netiek glabāts. Noma ir parakstīts marķieris, ko tur pārlūks, tāpēc iesūtne, kurai beidzies termiņš, neatstāj nevienu rindu, un adrese vienkārši pārstāj būt aizņemta.

Iznīcināta iesūtne joprojām tiek ieskaitīta izdošanas griestos. Tās izmešana nav veids, kā nopirkt vēl vienu.