API

Uzskaitīt pielikumus

Viena ziņojuma daļas ar to baitiem, base64.

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

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

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

Viena ziņojuma daļas ar to baitiem, base64.

Iesūtnes marķieris

shell

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

Katrs zemāk minētais izsaukums nes marķieri, ko atgrieza POST /temp-mail/inboxes, tajā pašā Authorization: Bearer galvenē, ko izmanto API atslēga. Pati adrese neko neautorizē, un šī nošķiršana ir funkcijas jēga, nevis formalitāte: vienreizlietojama adrese izdošanas brīdī tiek iedota tieši tai pusei, ko turat izstieptas rokas attālumā.

Ceļā norādītajam id jānosauc tā pati iesūtne, ko nosauc marķieris. Marķieris pats par sevi iesūtni identificē, tāpēc šī ir dubulta drošība, taču tas nozīmē, ka izsaucējs, kas sajaucis divas iesūtnes, saņem 404, nevis klusi lasa nepareizo pastu.

Piemērs

Metadati un saturs vienā atbildē, nevis saraksts plus atsevišķs pieprasījums katrai daļai. Vienreizlietojama iesūtne tur pāris mazus failus, un divi turp un atpakaļ gājieni, lai izlasītu PDF, šādā apjomā ir nepareizs darījums.

curl

curl "$OE/temp-mail/inboxes/tinb_9c2f41ab7d3e4c118a0f5d72/messages/tmail_4b81c07d2fa9418e93c6a13f/attachments" \  -H "$INBOX"

Atbilde

{  "object": "list",  "data": [    {      "object": "attachment",      "attachmentId": "tmail_4b81c07d2fa9418e93c6a13f-0",      "filename": "invoice.pdf",      "contentType": "application/pdf",      "size": 12345,      "content": "JVBERi0xLjQKJc…"    }  ]}

content ir null, kad daļa pārsniedza 8 MB glabāšanas griestus. Tas nav tukšs fails, un tieši tāpēc metadati tiek atdoti abos gadījumos, lai klients varētu pateikt „pārāk liels, lai saglabātu“, nevis rādīt 0 baitu lejupielādi.

Šos baitus piegādājis uzbrucējs, un tie pieņemti no anonīma sūtītāja. Visam, kas tos attēlo, tas jādara ārpus jūsu lietotnes izcelsmes (origin).