gPdf
Сценарії використання · API створення PDF

API створення PDF для динамічних бізнес-документів

Шукаєте генератор PDF? gPdf — це API JSON у PDF для розробників, яким потрібне автоматичне й пакетне створення PDF для етикеток, рахунків, звітів та архівних документів.

Задача

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

Чому gPdf підходить для цього сценарію

  • Створення JSON у PDF: один структурований DocumentRequest описує сторінки, текст, зображення, таблиці, штрихкоди й метадані.
  • API-first процес: викликайте POST /api/v1/pdf/render із бекенду, job runner, складської системи або SaaS-продукту.
  • Готовність до пакетного рендерингу: створюйте тисячі або мільйони PDF без керування парком браузерів.
  • Вбудовані шрифти для латиниці, CJK, арабської, деванагарі, бенгальської, тайської та кириличної писемності.
  • Векторні штрихкоди й фіксовані розміри етикеток для логістики, електронної комерції та складських документів.
  • PDF/A, метадані та параметри електронних рахунків, коли згенерованому документу потрібні архівування або вимоги відповідності.

Приклад запиту

POST /api/v1/pdf/render — мінімальний динамічний PDF, створений із JSON.

{
  "pages": [
    {
      "size": "a4",
      "elements": [
        {
          "type": "text",
          "x": 24,
          "y": 28,
          "content": "Order #A-10042",
          "style": {
            "font_size": 18,
            "font_family": "NotoSans-Regular"
          }
        },
        {
          "type": "text",
          "x": 24,
          "y": 44,
          "content": "Generated automatically from application data.",
          "style": {
            "font_size": 10,
            "font_family": "NotoSans-Regular"
          }
        },
        {
          "type": "barcode",
          "format": "code128",
          "content": "A-10042",
          "x": 24,
          "y": 70,
          "width": 80,
          "height": 18
        }
      ]
    }
  ]
}

Відповідність і conformance

  • Профілі PDF/A доступні, коли згенеровані PDF потрібно архівувати або прикріплювати до аудиторських доказів.
  • Метадані документа можна задати безпосередньо в тому самому запиті, щоб PDF мав стабільні title, author, subject і language.
  • Та сама структурована модель працює в API й у візуальному редакторі https://studio.gpdf.com.

Якщо потрібен лише разовий генератор PDF

Якщо потрібно конвертувати Word-документ, об’єднати два файли або експортувати одну сторінку в PDF, достатньо звичайного онлайн-генератора PDF. Такі інструменти створені для ручної роботи: завантажити файл, натиснути кнопку, отримати результат.

gPdf виконує іншу роботу. Він потрібен командам, яким треба, щоб власне програмне забезпечення автоматично створювало PDF.

Коли “генератор PDF” насправді означає “API створення PDF”

Пошуковий термін широкий, але production-вимога зазвичай конкретна:

  1. Клієнт оформлює замовлення, і ваша система має створити транспортну етикетку.
  2. SaaS-продукт має створювати щомісячні виписки або звіти.
  3. Фінансовий процес потребує рахунків із передбачуваними метаданими й архівними налаштуваннями.
  4. Складській системі потрібно 50 000 етикеток перед забором перевізником.
  5. Інструмент підтримки має створити брендовану PDF-квитанцію, сертифікат або експорт.

У всіх цих випадках головне питання не “яка кнопка створює PDF?”. Питання таке: чи може ваш бекенд повторювано, швидко й недорого створювати правильний PDF із даних?

Модель gPdf: JSON на вході, PDF на виході

gPdf використовує структуровану JSON-модель документа. Ваш застосунок надсилає:

  • розмір сторінки й координати макета;
  • текстові блоки й вибір шрифтів;
  • зображення й векторні штрихкоди;
  • таблиці, метадані й налаштування документа;
  • необов’язкові параметри PDF/A або електронного рахунку.

API повертає PDF. Немає браузерного сервера, який треба прогрівати, немає версії Chromium, яку треба фіксувати, і немає HTML/CSS рушія макета в гарячому шляху.

Чому це важливо для пакетного створення

Звичайні генератори PDF зручні для людини. Вони не створені для системи, яка генерує документи цілий день.

Для пакетного створення важливі інші властивості:

  • детермінований вивід для передруків і аудиторських слідів;
  • низька затримка p99, коли зростає черга;
  • прогнозована вартість за згенеровану сторінку;
  • шрифти й геометрія штрихкодів, які не змінюються разом із container images;
  • форма запиту, яку розробники можуть версіонувати й тестувати.

Саме на таке навантаження націлений gPdf.

Почніть із простого виклику API

Відкрийте Playground, якщо хочете спробувати JSON-модель перед підключенням коду. Коли будете готові інтегруватися, використовуйте довідник JSON Render API і надішліть той самий запит із бекенду.

Якщо перше навантаження — логістика, також прочитайте сценарій транспортних етикеток. Він показує ту саму модель для термоетикеток 4×6, штрихкодів перевізника й генерації під піковим навантаженням.

FAQ

gPdf — це онлайн-генератор PDF?
Не в сенсі ручного upload-and-convert інструмента для споживачів. gPdf — це API для автоматичного створення PDF всередині продуктів, бекендів і операційних систем.
Чи можна динамічно створювати PDF із JSON?
Так. DocumentRequest описує сторінки, текст, зображення, штрихкоди, таблиці, метадані й налаштування. Ваш застосунок надсилає JSON і отримує PDF.
Коли використовувати gPdf замість headless-браузера?
Використовуйте gPdf, коли документ структурований, повторюваний і високонавантажений: етикетки, рахунки, звіти, сертифікати та згенеровані бізнес-документи. Браузерний рендеринг усе ще корисний для довільних HTML-скриншотів.
Чи можуть не розробники проєктувати PDF?
Так. Візуальний редактор https://studio.gpdf.com працює з тією самою JSON-моделлю, тому операційна або дизайнерська команда може коригувати макет, а розробники зберігають API-first процес.

Читати далі