Przedłuż dzierżawę
Kolejna godzina do wygaśnięcia, aż do doby, którą ograniczona jest dzierżawa. Bez treści żądania.
Uruchamia prawdziwe wywołanie na twojej przestrzeni roboczej, twoim własnym kluczem.
POST /temp-mail/inboxes/{id}/extend
Kolejna godzina do wygaśnięcia, aż do doby, którą ograniczona jest dzierżawa. Bez treści żądania.
Token skrzynki
export OE=https://api.openemail.ukexport INBOX="Authorization: Bearer oe_inbox_kQ8v…"Każde wywołanie poniżej niesie token zwrócony przez POST /temp-mail/inboxes, w tym samym nagłówku Authorization: Bearer, którego używa klucz API. Sam adres nie autoryzuje niczego, a ten rozdział jest sednem tej funkcji, nie formalnością: adres jednorazowy trafia w ręce strony trzymanej na dystans w tej samej chwili, w której zostaje wydany.
Identyfikator w ścieżce musi wskazywać tę samą skrzynkę co token. Token sam w sobie wskazuje jedną skrzynkę, więc to zabezpieczenie na dwa sposoby, ale dzięki niemu klient, który pomyli dwie skrzynki, dostaje 404, zamiast po cichu czytać nie tę pocztę.
Przykład
Godzina jest dodawana do expiresAt, a nie do teraz, więc przedłużenie, gdy na zegarze jeszcze coś zostało, zachowuje ten czas.
curl -X POST "$OE/temp-mail/inboxes/tinb_9c2f41ab7d3e4c118a0f5d72/extend" -H "$INBOX"{ "object": "temp_inbox", "id": "tinb_9c2f41ab7d3e4c118a0f5d72", "address": "[email protected]", "domain": "freemailaddress.com", "createdAt": "2026-09-01T10:00:00.000Z", "expiresAt": "2026-09-01T13:00:00.000Z", "extensionsLeft": 21, "messageCount": 3, "messageLimit": 50, "lastMessageAt": "2026-09-01T10:31:04.000Z"}Dwadzieścia trzy przedłużenia, a nowe wygaśnięcie jest dodatkowo docinane do 24 godzin od createdAt, więc ostatnie może kupić mniej niż pełną godzinę, a dzierżawa utworzona od razu na maksimum nie ma ich wcale. extensionsLeft już liczy oba pułapy; odczytuj je i expiresAt z odpowiedzi, zamiast liczyć własne wywołania.
Przy limicie odpowiada 409 conflict_error / extension_limit. I na tym koniec: weź nowy adres albo prawdziwą skrzynkę, która nie wygasa.