Zur Dokumentation springen
API

Einen Posteingang zerstören

Löscht die Mail jetzt, statt auf das Ende der Laufzeit zu warten.

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

Führt den echten Aufruf gegen Ihren Workspace aus, mit Ihrem eigenen Schlüssel.

DELETE /temp-mail/inboxes/{id}

Löscht die Mail jetzt, statt auf das Ende der Laufzeit zu warten.

Das Posteingangs-Token

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

Jeder Aufruf unten trägt das Token, das POST /temp-mail/inboxes zurückgegeben hat, im selben Authorization: Bearer-Header, den ein API-Key verwendet. Die Adresse selbst autorisiert nichts, und diese Trennung ist der Sinn des Features und keine Formalie: Eine Wegwerfadresse wird in dem Moment, in dem sie ausgestellt wird, der Partei übergeben, die Sie auf Abstand halten.

Die ID im Pfad muss denselben Posteingang nennen wie das Token. Das Token allein identifiziert bereits einen, das ist also doppelt gemoppelt, aber es bedeutet, dass ein Aufrufer, der zwei Posteingänge verwechselt, einen 404 bekommt, statt stillschweigend die falsche Mail zu lesen.

Beispiel

Die Nachrichten und ihre gespeicherten Bodys verschwinden sofort, und das Token authentifiziert ab der nächsten Anfrage nicht mehr.

curl
curl -X DELETE "$OE/temp-mail/inboxes/tinb_9c2f41ab7d3e4c118a0f5d72" -H "$INBOX"
Antwort
{ "object": "temp_inbox", "id": "tinb_9c2f41ab7d3e4c118a0f5d72", "destroyed": true }

Serverseitig wird nichts gespeichert. Die Lease ist ein signiertes Token, das der Browser hält, ein abgelaufener Posteingang hinterlässt daher keine Zeile und die Adresse wird schlicht nicht mehr beansprucht.

Ein zerstörter Posteingang zählt weiterhin gegen die Obergrenze für neu erstellte Posteingänge. Einen wegzuwerfen ist kein Weg, einen weiteren zu bekommen.