FAQ

Питання, які розробники справді ставлять.

Дванадцять відповідей — цитуються дослівно JSON-LD FAQPage, який споживають Google rich results.

/01

Наскільки швидко gPdf рендерить PDF?

p50 — 3 мс, p99 — 8 мс на одній сторінці A4 при вимірюванні на 1000 викликах. Загальний edge-час із мережею зазвичай 8-15 мс.

/02

Який формат введення приймає API?

Тіло DocumentRequest у JSON. Сторінки, елементи, шари, водяні знаки, заголовки, нижні колонтитули та таблиці виражаються структурно — без HTML, без Markdown, без браузерного проходу layout.

/03

Як gPdf порівнюється з Puppeteer або headless Chrome?

Headless Chromium працює 200-800 мс на рендер і потребує контейнер 800 МБ. gPdf рендерить ту саму сторінку A4 за 3 мс усередині V8-isolate 1 МБ, без холодного старту. Компроміс — формат вводу: gPdf приймає JSON DocumentRequest, не сирий HTML.

/04

Які кінцеві точки API gPdf?

Три: /api/v1/pdf/render приймає повний DocumentRequest для попіксельного контролю. /api/v1/template-render приймає template_id плюс масив даних. /api/v1/e-invoice/render виробляє гібридні рахунки Factur-X / ZUGFeRD. Усі три використовують один рушій, ті самі ліміти запитів і ту саму поверхню кодів помилок.

/05

Чи потрібно встановлювати шрифти на сервер для китайської, японської або корейської?

Ні. NotoSans CJK вбудовано і автоматичний ланцюг fallback обробляє відсутні гліфи. Ви ніколи не побачите тофу-боксів і вам не потрібно apt install fonts-noto-cjk на runtime.

/06

Які штрих-коди я можу рендерити?

Понад 30 символік включно з QR, GS1-128, PDF417, DataMatrix, Aztec, MaxiCode і Code 128. Усі векторні. Загальна довжина штрих-коду в межах 0,1 мм від запитаного розміру — достатньо точно для ширини етикеток за специфікаціями GS1 та ITF-14.

/07

Чи виробляє gPdf вивід, відповідний PDF/A або електронному рахунку?

Так. PDF/A-1b, 2b, 3b і 4 вибираються на запит. Потоки вкладень Factur-X і ZUGFeRD підтримуються для сценаріїв електронних рахунків.

/08

Чи може gPdf виробляти рахунки Factur-X, ZUGFeRD або EN 16931?

Так. Установіть settings.profile у pdfa-3b і прикріпіть структурований XML payload як файловий потік. Factur-X та ZUGFeRD базуються на PDF/A-3 — це потрібно для чинного німецького мандату e-invoicing і французького B2B-мандату з вересня 2026.

/09

Де gPdf насправді працює?

Усередині V8-isolate Cloudflare Workers. Немає Chromium-контейнера, немає Lambda warming, немає персистентності документів після запиту.

/10

Чи зберігає gPdf мої PDF або вхідні дані?

Ні. Renderer stateless. Ваш DocumentRequest живе в V8-isolate декілька мілісекунд рендерингу, потім зникає. У gPdf немає шару кешування і сховища документів.

/11

Чи є безкоштовний рівень?

Так. Free Trial дає 100 сторінок на день, без кредитної картки. Скидається щодня і зупиняється на квоті. Платні рівні починаються від $5 на місяць за 100 000 сторінок.

/12

Як почати використовувати gPdf?

Відкрийте playground вище, відредагуйте DocumentRequest і натисніть Створити PDF — живий edge-worker повертає справжній PDF. Скопіюйте curl-сніпет у свій термінал, щоб викликати його звідки завгодно.