Це окремий endpoint?

API: JSON у PDF зіставляє сценарій з публічною API gPdf. Сторінка пояснює, який шлях викликати і що має містити request.

Можна використовувати templates?

Так. JSON Render підходить, поки layout змінюється; Template Render — коли layout затверджено і callers надсилають лише бізнес-дані.

Що перевірити перед production?

Перевіряйте реальні дані й downstream-системи: принтери, сканери, валідатори, бухгалтерію або marketplace.

Developer workflows

JSON у PDF: API для production-систем

Генерація JSON у PDF зі структурованих backend-даних без браузера: gPdf відповідає за PDF-рендеринг, бізнес-правила залишаються у вашій системі.

ОСНОВНА API JSON Render

ENDPOINT /api/v1/pdf/render

СИСТЕМИ операційний backend / фінансова система / workflow compliance / сервіс документів

Спробувати в Playground → Читати документацію

Задача сценарію

Генерація JSON у PDF як відтворюваного PDF зі структурованих даних. gPdf створює документ; ваша система відповідає за зміст даних і стан процесу.

Коли використовувати цю API

Backend уже містить дані для JSON у PDF і потрібна стабільна PDF-відповідь.
Потрібно уникнути Chromium або HTML-to-PDF в операційному документі.
Потрібен повторюваний результат для передруку, аудиту або пакетної обробки.

Що вона не замінює

gPdf не купує доставку, не подає податки, не створює зовнішні замовлення і не є фіскальною системою.
gPdf не замінює бізнес-логіку, перевірку даних та інтеграції з marketplace.

Який endpoint викликати

ОСНОВНИЙ

/api/v1/pdf/render

JSON Render — типовий шлях для цього сценарію.

ДОДАТКОВИЙ 1

/api/v1/template-render

Використовуйте, коли сценарію потрібен пов’язаний API-шлях, контракт шаблону або перевірка можливостей.

Мінімальний request

/api/v1/pdf/render - JSON у PDF

{
  "pages": [
    {
      "size": "a4",
      "elements": [
        {
          "type": "text",
          "x": 20,
          "y": 24,
          "content": "Hello from gPdf",
          "style": {
            "font_size": 18,
            "font_family": "NotoSans-Regular"
          }
        }
      ]
    }
  ]
}

Що виконує gPdf

PDF-рендеринг для JSON у PDF зі структурованого request.
Текст, таблиці, лінії, штрихкоди, сторінки, метадані та параметри виводу згідно з request.
Детермінований вивід для retries, передруку й аудиту.

Що контролює ваша система

Коректні дані для JSON у PDF, бізнес-правила і стан операції.
Автентифікація, зберігання, зовнішні workflow і приймальні перевірки.

Production checklist

Перевірте на реальних даних і в системах, які прийматимуть PDF.
Зберігайте request ID і докази перевірки для підтримки, аудиту та передруку.
Переведіть затверджений layout у template, якщо ним користуються кілька систем.

Межі заявлених можливостей

gPdf рендерить PDF із request; він не замінює workflow продукту, базу даних або бізнес-валідацію.
Ваша система відповідає за семантику даних, retries, зберігання і фінальне приймання.

Форма API

API: JSON у PDF — production workflow на публічних API gPdf. Request описує дані, layout, settings і PDF-частини для рендерингу. gPdf створює PDF, а ваша система зберігає зміст бізнес-події.

Вибір endpoint

Для цього сценарію endpoint за замовчуванням — /api/v1/pdf/render. Template Render використовуйте після затвердження layout. E-Invoice Render використовуйте лише для Factur-X / ZUGFeRD PDF/A-3b із вбудованим EN 16931 CII XML.

Перевірка перед production

Перевіряйте JSON у PDF на реальних даних і в downstream-системах. Зберігайте request ID, PDF і результати перевірок для підтримки, аудиту та передруку.

FAQ

Це окремий endpoint?: API: JSON у PDF зіставляє сценарій з публічною API gPdf. Сторінка пояснює, який шлях викликати і що має містити request.
Можна використовувати templates?: Так. JSON Render підходить, поки layout змінюється; Template Render — коли layout затверджено і callers надсилають лише бізнес-дані.
Що перевірити перед production?: Перевіряйте реальні дані й downstream-системи: принтери, сканери, валідатори, бухгалтерію або marketplace.