Ga direct naar de documentatie
API

Een inbox ophalen

De lease, het aantal berichten en de resterende verlengingen. De status die een client rond de lijst tekent.

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

Voert de echte aanroep uit op je workspace, met je eigen sleutel.

GET /temp-mail/inboxes/{id}

De lease, het aantal berichten en de resterende verlengingen. De status die een client rond de lijst tekent.

Het inbox-token

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

Elke aanroep hieronder draagt het token mee dat POST /temp-mail/inboxes teruggaf, in dezelfde Authorization: Bearer-header die een API-sleutel gebruikt. Het adres zelf autoriseert niets, en die scheiding is juist de kern van de functie in plaats van een formaliteit: een wegwerpadres wordt op het moment van uitgifte overhandigd aan de partij die je op afstand houdt.

De id in het pad moet dezelfde inbox aanwijzen als het token. Het token identificeert er op zichzelf al een, dus dit is dubbelop, maar het betekent wel dat een client die twee inboxen door elkaar haalt een 404 krijgt in plaats van stilletjes de verkeerde post te lezen.

Voorbeeld

Goedkoop: één geïndexeerde rij en geen objectopslag. Poll in plaats daarvan de berichtenlijst als het je om post te doen is. Die aanroep draagt de vervaltijd ook mee.

curl
curl "$OE/temp-mail/inboxes/tinb_9c2f41ab7d3e4c118a0f5d72" -H "$INBOX"
Antwoord
{  "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"}

Een verlopen, vernietigde of onbekende inbox levert één antwoord op: 404. "Je lease is afgelopen", "die is niet van jou" en "die heeft nooit bestaan" zijn van buitenaf met opzet niet te onderscheiden, en de mailbox weigert ze om dezelfde reden uit elkaar te houden.