Штрихкоди та роздріб
QR Code PDF API для документів і етикеток
Рендерте QR-коди всередині PDF для квитанцій, квитків, етикеток, пакетів онбордингу й процесів пошуку документів через JSON Render або шаблони.
ОСНОВНА API JSON Render
ШЛЯХ API
/api/v1/pdf/render СИСТЕМИ SaaS-бекенд / бекенд електронної комерції / квитковий бекенд / сервіс автоматизації документів
Задача сценарію
Розміщувати QR-коди в PDF-документах, етикетках, квитанціях, квитках або формах, щоб користувачі могли сканувати посилання, ідентифікатор або токен пошуку, які контролює ваша система.
Коли використовувати цю API
- У вашій системі є URL, token, ID замовлення, ID квитка або значення пошуку для кодування.
- Потрібно намалювати QR-код у PDF, а не компонувати його як зовнішнє растрове зображення.
- Потрібні повторювані QR-макети через Template Render.
- Потрібен один шлях API для тексту, макета, PDF-виводу й рендерингу QR-коду.
Що вона не замінює
- Потрібне скорочення URL, видача access token або створення платіжного посилання від gPdf.
- Потрібні аналітика сканерів або логіка мобільного застосунку.
- Потрібні QR-коди поза PDF-виводом.
Який шлях API викликати
/api/v1/pdf/render
JSON Render — типовий шлях для цього сценарію.
/api/v1/template-render
Використовуйте, коли сценарію потрібен пов’язаний API-шлях, контракт шаблону або перевірка можливостей.
Мінімальний запит
POST /api/v1/pdf/render - сторінка документа з QR-кодом для пошуку.
{
"pages": [
{
"size": "a4",
"elements": [
{
"type": "text",
"x": 20,
"y": 24,
"content": "Scan to view this document online",
"style": { "font_size": 14, "font_family": "NotoSans-Regular" }
},
{
"type": "barcode",
"format": "qrcode",
"content": "https://example.com/documents/DOC-2026-001",
"x": 20,
"y": 44,
"width": 32,
"height": 32
}
]
}
]
}
Що виконує gPdf
- Рендеринг векторного QR-штрихкоду всередині PDF-виводу.
- Текст, макет, контекст квитанції, квитка, етикетки або документа навколо QR-коду.
- Прив’язку шаблону для повторюваних QR-процесів.
- Доставку PDF-відповіді через публічні render API.
Що контролює ваша система
- Закодований URL або token, контроль доступу, строк дії, поведінку редиректу й мобільну ціль.
- Тестування сканування, шлях користувача й правила запобігання шахрайству.
- Будь-яку платіжну, квиткову, return або account-дію після сканування.
Чеклист для робочого запуску
- Тримайте закодовані URL стабільними або redirectable протягом життєвого циклу документа.
- Тестуйте відстань сканування, контраст, розмір і матеріал друку.
- Уникайте прямого вбудовування чутливих необроблених даних у QR-дані.
- Використовуйте request IDs і логуйте бізнес-об’єкт, пов’язаний із кожним згенерованим PDF.
- Переносьте стабільні QR-макети в Template Render.
Межі заявлених можливостей
- gPdf рендерить QR-коди в PDF; він не хостить і не захищає ціль після сканування.
- Ваша система відповідає за строк дії token, редиректи, дозволи й UX сканування.
- QR-код сам по собі не є платіжною або квитковою системою.
Сторінкам із QR-кодами все одно потрібна чітка семантика
QR-код — лише видимий носій. Бойовий процес залежить від цілі або token за ним. gPdf малює QR-код у PDF; ваша система відповідає за те, що відбувається після сканування.
FAQ
- Чи генерує gPdf зображення QR-кодів?
- gPdf рендерить елементи QR-коду всередині PDF-виводу. Публічна відповідь — PDF, а не окремий сервіс зображень.
- Чи можна використовувати QR-коди в шаблонах?
- Так. Шаблон може містити QR-поля, а сервіси-викликачі можуть надсилати змінні дані.
- Хто відповідає за ціль QR-коду?
- Ваша система відповідає за URLs, tokens, redirects, permissions і поведінку строку дії.
- Чи може QR-код містити чутливі дані?
- Він може закодувати все, що ви надсилаєте, але бойовим системам зазвичай варто кодувати токен пошуку або URL, а не необроблені чутливі дані.