/01
Насколько быстро gPdf рендерит PDF?
p50 — 3 мс, p99 — 8 мс на одной странице A4 при измерении на 1000 вызовах. Полное edge-время с учётом сети обычно 8-15 мс.
FAQ
Вопросы, которые разработчики действительно задают.
Двенадцать ответов — цитируются дословно JSON-LD FAQPage, который потребляют Google rich results.
/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 (PDF/A-3 + встроенный XML). Все три разделяют один движок, одни лимиты скорости и одну поверхность кодов ошибок.
/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 — требуются для немецкого мандата электронных счетов, уже действующего, и французского B2B мандата с сентября 2026.
/09
Где gPdf на самом деле работает?
Внутри V8-isolates Cloudflare Workers. Нет Chromium-контейнера, нет Lambda warming, нет персистентности документов после запроса.
/10
Хранит ли gPdf мои PDF или входные данные?
Нет. Рендерер stateless. Ваш DocumentRequest живёт в V8-isolate несколько миллисекунд рендеринга, затем исчезает. У gPdf нет слоя кэширования и хранилища документов — отсутствие состояния является контрактом, а не опцией.
/11
Есть ли бесплатный уровень?
Да. Free Trial даёт 100 страниц в день, без кредитной карты. Сбрасывается ежедневно и останавливается на квоте — никаких сюрприз-счетов. Платные уровни начинаются от $5 в месяц за 100 000 страниц.
/12
Как начать использовать gPdf?
Откройте playground выше, отредактируйте DocumentRequest и нажмите Создать PDF — живой edge-worker возвращает реальный PDF. Скопируйте curl-сниппет в свой терминал, чтобы вызывать его откуда угодно. Playground не требует установки и кредитной карты; учётная запись нужна только для выпуска собственного API-ключа.