Preskočiť na obsah
Frontmail Docs

Prílohy a vložené obrázky

Frontmail podporuje štyri spôsoby, ako k e-mailu pridať súbory. Prílohy sú dostupné na platených tarifoch; maximálna celková veľkosť na požiadavku závisí od tarifu (pozrite Tarify).

Spôsob Kde sa nastavuje Na čo sa hodí
Statické prílohy Nastavenia šablóny Rovnaký súbor v každom e-maile (cenník, obchodné podmienky v PDF)
Dynamické v base64 attachments v požiadavke na odoslanie Malé generované súbory (≤ niekoľko stoviek kB)
Nahrávanie súborov POST /v1/uploads, potom attachments: [{ upload_id }] Väčšie súbory, súbory vybrané používateľmi
Súbory z formulára Súborové polia pri sendForm() / /v1/send-form Súbory priložené k HTML formuláru

Statické prílohy

Section titled “Statické prílohy”

Statické prílohy sú súbory pripojené ku každému e-mailu odoslanému so šablónou (najviac 10 na šablónu). Ukladajú sa v S3 a započítavajú sa do limitu veľkosti na požiadavku. Editor šablón ich zobrazuje v časti Nastavenia → Ochrana → Statické prílohy; nahrávať ich z dashboardu zatiaľ nemožno – ak nejakú potrebujete nastaviť, napíšte na support@frontmail.dev.

Dynamické prílohy

Section titled “Dynamické prílohy”

Najprv v šablóne zapnite Povoliť prílohy z formulára v časti Nastavenia → Ochrana; inak požiadavky s prílohami zlyhajú s chybou attachments_not_allowed.

Base64 v požiadavke

Section titled “Base64 v požiadavke”
await send('svc_01J9…', 'tpl_invoice', { name: 'Jana' }, {
  attachments: [
    { filename: 'faktura.pdf', contentType: 'application/pdf', contentBase64: pdfBase64 },
  ],
});
"attachments": [
  { "filename": "faktura.pdf", "content_type": "application/pdf", "content_base64": "JVBERi0xLjcK…" }
]

Base64 zväčší požiadavku o tretinu – na čokoľvek väčšie ako niekoľko stoviek kilobajtov použite nahrávanie súborov.

Nahrávanie súborov

Section titled “Nahrávanie súborov”

  1. Vyžiadajte si URL na nahranie (verejným alebo súkromným kľúčom):

    Terminal window
    curl https://api.frontmail.dev/v1/uploads \
      -H 'Content-Type: application/json' \
      -H 'X-Frontmail-Public-Key: pk_4f2a…' \
      -d '{ "filename": "cv.pdf", "content_type": "application/pdf", "size": 482113 }'
    {
      "upload_id": "upl_01J9Z3",
      "url": "https://uploads.frontmail.dev/…",
      "method": "PUT",
      "headers": { "Content-Type": "application/pdf" },
      "expires_at": "2026-09-24T11:00:00Z"
    }

  2. Pred expires_at nahrajte súbor metódou PUT na url s vrátenými headers.

  3. Odkážte naň pri odoslaní: "attachments": [{ "upload_id": "upl_01J9Z3" }].

Deklarovaná veľkosť size sa vopred overí voči limitu vášho tarifu (attachment_too_large) a uložený objekt sa skontroluje znova pri odoslaní správy.

Súbory z formulára

Section titled “Súbory z formulára”

Pri sendForm() sa každé <input type="file"> vo formulári stane prílohou:

<input type="file" name="cv" accept="application/pdf">

Blokované typy a názvy súborov

Section titled “Blokované typy a názvy súborov”

Dynamické prílohy môže poslať ktokoľvek, kto používa váš formulár, preto Frontmail odmieta typy súborov, ktoré spúšťajú kód alebo bežne slúžia na phishing, s chybou attachments_not_allowed: spustiteľné súbory a inštalátory (.exe, .msi, .msix, .appx, .scr, .com, .bat, .cmd, .cpl, .dll, .jar, .app, .pkg, …), skripty (.js, .jse, .vbs, .wsf, .ps1, .hta, …), zástupcov (.lnk, .url, .library-ms, …), obrazy diskov (.iso, .img, .vhd, .vhdx, .dmg), webové stránky a vektorové obrázky (.html, .htm, .xhtml, .mht, .svg), OneNote (.one) a súbory Office s makrami (.docm, .xlsm, .pptm, …). Názvy súborov sa najprv vyčistia: odstránia sa neviditeľné znaky a znaky sprava doľava (ktorými sa invoice<U+202E>fdp.exe maskuje ako invoiceexe.pdf) aj bodky či medzery na konci, takže report.exe. sa počíta ako .exe.

S verejným kľúčom vyžaduje POST /v1/uploads aj aspoň jednu šablónu, ktorá povoľuje prílohy z formulára, a nahrávanie má v rámci organizácie spoločný denný rozpočet 200 × limit príloh vášho tarifu.

Vložené obrázky

Section titled “Vložené obrázky”

Máte dve možnosti:

  • Hostované obrázky – v <img src> použite absolútnu URL https://. Najlepšie pre logá a dekorácie: e-maily zostanú malé a klienti obrázky načítajú, až keď sú potrebné.
  • Obrázky cez CID – statická príloha s content ID, napr. logo, na ktorú odkážete ako <img src="cid:logo" alt="Example s.r.o.">. Obrázok je vložený priamo v e-maile, takže sa zobrazí aj pri blokovaní externých obrázkov, no každý e-mail zväčší.

Obrázkom vždy nastavte alt – kontroly šablóny upozornia, keď chýba.