Zur Dokumentation springen
API

Eine Nachricht löschen

Eine Nachricht, ihr Body und ihre Anhänge, auf Ihren Wunsch hin statt durch den Aufräumlauf.

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

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

DELETE /temp-mail/inboxes/{id}/messages/{messageId}

Eine Nachricht, ihr Body und ihre Anhänge, auf Ihren Wunsch hin statt durch den Aufräumlauf.

Das Postfach-Token

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

Jeder Aufruf unten führt das Token mit, das POST /temp-mail/inboxes zurückgegeben hat, im selben Authorization: Bearer-Header, den ein API-Schlüssel verwendet. Die Adresse selbst autorisiert nichts, und diese Trennung ist der Sinn der Funktion und keine Formalität: Eine Wegwerfadresse wird in dem Moment, in dem sie ausgestellt wird, genau der Gegenseite übergeben, die Sie auf Abstand halten wollen.

Die id im Pfad muss dasselbe Postfach benennen wie das Token. Das Token allein identifiziert eines, also ist dies doppelt gemoppelt; es bedeutet aber, dass ein Aufrufer, der zwei Postfächer verwechselt, ein 404 bekommt, statt stillschweigend die falsche Post zu lesen.

Beispiel

Die Zeile und jedes Objekt darunter gehen gemeinsam. messageCount bleibt unverändert: Die Obergrenze von 50 Nachrichten zählt, was eingegangen ist, Löschen gibt also Speicher frei, aber keinen Platz.

curl
curl -X DELETE "$OE/temp-mail/inboxes/tinb_9c2f41ab7d3e4c118a0f5d72/messages/tmail_4b81c07d2fa9418e93c6a13f" \  -H "$INBOX"
Response
{ "object": "temp_message", "id": "tmail_4b81c07d2fa9418e93c6a13f", "deleted": true }

Es gibt keinen Papierkorb und kein Wiederherstellen. Bei einem Wegwerfpostfach ist das die Funktion.

Ein volles Postfach bleibt voll. Post, die es erreicht, wird an der Tür verworfen, ohne Bounce und ohne dass sich später etwas abrufen ließe; der Weg nach vorn ist also eine neue Adresse und kein Ausmisten.