API

Listo mesazhet

Çfarë ka mbërritur, më të rejat të parat, vetëm metadata. Kjo është thirrja që pyetet periodikisht.

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

Ekzekuton thirrjen reale kundrejt hapësirës suaj të punës, me çelësin tuaj.

GET /temp-mail/inboxes/{id}/messages

Çfarë ka mbërritur, më të rejat të parat, vetëm metadata. Kjo është thirrja që pyetet periodikisht.

Token-i i kutisë hyrëse

shell

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

Çdo thirrje më poshtë mbart token-in që ktheu POST /temp-mail/inboxes, në të njëjtin header Authorization: Bearer që përdor një çelës API. Vetë adresa nuk autorizon asgjë, dhe kjo ndarje është thelbi i veçorisë e jo një formalitet: një adresë e përkohshme i jepet palës që po mbani në distancë që në çastin kur lëshohet.

Id-ja në shteg duhet të emërtojë të njëjtën kuti hyrëse që emërton token-i. Vetëm token-i e identifikon njërën, ndaj kjo është masë dyfishe sigurie, por do të thotë se një thirrës që ngatërron dy kuti merr një 404 në vend që të lexojë në heshtje postën e gabuar.

Shembull

Gjithçka që vizaton një listë është një kolonë në një tabelë të vetme të indeksuar, dhe asnjë trup i ruajtur nuk lexohet. limit shkon nga 1 deri në 50 dhe është opsional; afati kthehet në të njëjtën përgjigje, ndaj një pyetës periodik nuk ka nevojë për një thirrje të dytë për të ditur kur të ndalojë.

curl

curl "$OE/temp-mail/inboxes/tinb_9c2f41ab7d3e4c118a0f5d72/messages?limit=25" -H "$INBOX"

Përgjigje

{  "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 janë 400 karakteret e para të trupit si tekst, që zakonisht është e gjithë arsyeja pse ekziston kutia. Një kod konfirmimi zakonisht duket pa hapur asgjë.

spam është ajo që mendoi heuristika e përbashkët. Është vetëm një shenjë dhe asgjë më shumë: asgjë nuk u arkivua, nuk u zhvendos dhe nuk u shtyp, dhe mesazhi ndodhet në këtë listë sido që të jetë.

seen ndryshon kur mesazhi merret, jo kur listohet. Pyetja periodike e këtij endpoint-i nuk shënon kurrë asgjë si të lexuar.