API

Ziņojumu saraksts

Kas ir pienācis, jaunākie vispirms, tikai metadati. Šis ir izsaukums, ko aptaujāt.

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

Izpilda īstu izsaukumu pret jūsu darbvietu, ar jūsu paša atslēgu.

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

Kas ir pienācis, jaunākie vispirms, tikai metadati. Šis ir izsaukums, ko aptaujāt.

Iesūtnes tokens

shell

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

Katrs zemāk minētais izsaukums nes tokenu, ko atgrieza POST /temp-mail/inboxes, tajā pašā Authorization: Bearer galvenē, kuru izmanto API atslēga. Pati adrese neautorizē neko, un šī nošķirtība ir funkcijas jēga, nevis formalitāte: vienreizlietojamā adrese tiek nodota tai pusei, kuru turat attālumā, tieši tajā brīdī, kad tā tiek izsniegta.

Ceļā norādītajam id jānosauc tā pati iesūtne, ko nosauc tokens. Tokens viens pats jau identificē vienu, tāpēc šī ir dubulta drošība, taču tas nozīmē, ka izsaucējs, kas sajauc divas iesūtnes, saņem 404, nevis klusi lasa svešu pastu.

Piemērs

Viss, ko saraksts uzzīmē, ir kolonna vienā indeksētā tabulā, un neviens saglabātais saturs netiek lasīts. limit ir no 1 līdz 50 un nav obligāts; noma atgriežas tajā pašā atbildē, tāpēc aptaujātājam nav vajadzīgs otrs izsaukums, lai zinātu, kad apstāties.

curl

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

Atbilde

{  "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 ir pirmās 400 satura rakstzīmes kā teksts, kas parasti arī ir viss iemesls, kāpēc iesūtne pastāv. Apstiprinājuma kods parasti ir redzams, neko neatverot.

spam ir tas, ko nosprieda koplietotā heiristika. Tas ir karodziņš un nekas vairāk: nekas netika kaut kur nošķirts, pārvietots vai apslāpēts, un ziņojums šajā sarakstā ir jebkurā gadījumā.

seen pārslēdzas, kad ziņojums tiek iegūts, nevis kad tas tiek uzskaitīts. Šī galapunkta aptaujāšana nekad neko neatzīmē kā lasītu.