Nachrichten auflisten
Was eingegangen ist, neueste zuerst, nur Metadaten. Das ist der Aufruf zum Pollen.
Führt den echten Aufruf gegen Ihren Workspace aus, mit Ihrem eigenen Schlüssel.
GET /temp-mail/inboxes/{id}/messages
Was eingegangen ist, neueste zuerst, nur Metadaten. Das ist der Aufruf zum Pollen.
Das Postfach-Token
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
Alles, was eine Liste zeichnet, ist eine Spalte einer einzigen indizierten Tabelle, und kein gespeicherter Body wird gelesen. limit liegt zwischen 1 und 50 und ist optional; die Leihfrist kommt in derselben Antwort mit, ein Poller braucht also keinen zweiten Aufruf, um zu wissen, wann er aufhören soll.
curl "$OE/temp-mail/inboxes/tinb_9c2f41ab7d3e4c118a0f5d72/messages?limit=25" -H "$INBOX"{ "object": "list", "data": [ { "object": "temp_message", "id": "tmail_4b81c07d2fa9418e93c6a13f", "from": { "name": "Acme", "email": "[email protected]" }, "to": "[email protected]", "subject": "Confirm your email", "snippet": "Your code is 481923…", "spam": false, "seen": false, "attachmentCount": 0, "sizeBytes": 8241, "receivedAt": "2026-09-01T10:31:04.000Z" } ], "expiresAt": "2026-09-01T12:00:00.000Z"}snippet sind die ersten 400 Zeichen des Bodys als Text, und das ist meist der ganze Grund, warum das Postfach existiert. Ein Bestätigungscode ist in der Regel sichtbar, ohne dass man etwas öffnen muss.
spam ist das, was die gemeinsame Heuristik dachte. Es ist ein Kennzeichen und sonst nichts: Es wurde nichts abgelegt, verschoben oder unterdrückt, und die Nachricht steht so oder so in dieser Liste.
seen kippt, wenn die Nachricht abgerufen wird, nicht wenn sie aufgelistet wird. Das Pollen dieses Endpunkts markiert nie etwas als gelesen.