API

Pobierz skrzynkę

Dzierżawa, licznik wiadomości i pozostałe przedłużenia. Stan, który klient rysuje wokół listy.

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

Uruchamia prawdziwe wywołanie na twojej przestrzeni roboczej, twoim własnym kluczem.

GET /temp-mail/inboxes/{id}

Dzierżawa, licznik wiadomości i pozostałe przedłużenia. Stan, który klient rysuje wokół listy.

Token skrzynki

shell

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

Tanie: jeden zaindeksowany wiersz i żadnego sięgania do magazynu obiektów. Jeśli chodzi ci o pocztę, odpytuj zamiast tego listę wiadomości. Tamto wywołanie niesie też wygaśnięcie.

curl

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

Odpowiedź

{  "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": 3,  "messageLimit": 50,  "lastMessageAt": "2026-09-01T10:31:04.000Z"}

Skrzynka wygasła, zniszczona i nieznana to jedna odpowiedź: 404. „Twoja dzierżawa się skończyła”, „to nie jest twoje” i „to nigdy nie istniało” są z zewnątrz nie do odróżnienia, i to celowo, a prawdziwa skrzynka odmawia ich rozróżniania z tego samego powodu.