Generátor PDF

Koncový bod

POST https://pdf.bizkithub.com/generator

Odešlete HTML jako tělo požadavku (text/html nebo prostý text). Parametry dotazu řídí velikost papíru, okraje a režim stránkování.

Parametry dotazu

Parametr	Typ	Chování
content	string	HTML obsah. Obvykle se odesílá jako tělo POST požadavku; může být poskytnut jako ?content= pro GET požadavky.
format	string	Standardní formát papíru (A4, Letter, …). Používá se, když není nastaveno width. Výchozí je A4.
width	string	Vlastní šířka stránky jako CSS délka (80mm, 210mm, 800px). Přepíše format a explicitně nastaví velikost stránky.
height	string	Vlastní výška stránky (CSS délka). Používá se pouze v režimu pevné velikosti. Pokud je nastaveno width a fitHeight je vypnuto, výška se standardně nastaví na výšku A4 (297mm).
autoHeight	boolean	Přepíná z nulových okrajů na bezpečné okraje pro tisk, které se důsledně aplikují napříč stránkami. Zlepšuje zalomení stránek a zabraňuje oříznutí na okrajích stránek.
margin	string	Přepíše velikost okraje, když autoHeight=true. Přijímá CSS zkrácený zápis (1–4 hodnoty), např. 12mm 10mm nebo 2mm.
fitHeight	boolean	Režim účtenky: generuje jednostránkové PDF, jehož výška je odvozena od vykresleného obsahu. Nejlépe se kombinuje s width (např. 80 mm).
uuid	string	Volitelný identifikátor uložený v klíčových slovech metadat PDF.
author	string	Volitelný štítek autora zahrnutý v metadatech PDF (Autor, Tvůrce, Producent).

Výchozí nastavení. Bez autoHeight jsou okraje nulové. S autoHeight=true se aplikují rozumné okraje pro tisk – ve stylu A4 pro standardní stránky, menší okraje pro úzké šířky účtenek. Pro přepsání použijte margin.

Jak se velikosti kombinují

1. Priorita velikosti papíru. Pokud je zadáno width, stane se primárním vstupem pro velikost a přepíše format. Pokud je zadáno i height, velikost stránky je plně explicitní.
2. Okraje. Okraje jsou ve výchozím nastavení nulové; autoHeight=true umožňuje bezpečné okraje pro tisk, které se důsledně aplikují napříč stránkami.
3. Režim účtenky. S fitHeight=true je výstupem jedna stránka, jejíž výška je odvozena od vykresleného obsahu — nejlépe se používá s pevnou width.

Příklady

Výchozí (nulové okraje) — plná plocha, obsah si řídí vlastní odsazení:

POST https://pdf.bizkithub.com/generator

A4 s bezpečnými okraji pro tisk — doporučeno pro vícestránkové dokumenty:

POST https://pdf.bizkithub.com/generator?autoHeight=true

Úzká stránkovaná stránka:

POST https://pdf.bizkithub.com/generator?autoHeight=true&width=80mm

Režim účtenky — jedna stránka, automatická výška:

POST https://pdf.bizkithub.com/generator?autoHeight=true&fitHeight=true&width=80mm&margin=2mm

Vlastní velikost štítku / lístku:

POST https://pdf.bizkithub.com/generator?autoHeight=true&width=100mm&height=150mm&margin=4mm

JavaScript pomocník

async function generatePDF(html, opts = {}) {
const params = new URLSearchParams();
if (opts.autoHeight) params.set('autoHeight', 'true');
if (opts.width) params.set('width', opts.width);
if (opts.fitHeight) params.set('fitHeight', 'true');
if (opts.margin) params.set('margin', opts.margin);
const response = await fetch(`https://pdf.bizkithub.com/generator?${params}`, {
method: 'POST',
headers: { 'Content-Type': 'text/html' },
body: html,
});
if (!response.ok) throw new Error('PDF generation failed');
return response.blob();
}

Poznámky

• V režimu více stránek udržujte HTML rozvržení vhodné pro tisk — vyhněte se kontejnerům s pevnou výškou kolem dlouhého obsahu.
• Pro účtenky v režimu fitHeight nechte text přirozeně zalamovat, místo abyste vynucovali šířky na podřízených prvcích.