Штрихкоды и retail
QR code PDF API для documents и labels
Рендерьте QR codes внутри PDF для receipts, tickets, labels, onboarding packets и document lookup workflows через JSON Render или templates.
ОСНОВНАЯ API JSON Render
ENDPOINT
/api/v1/pdf/render СИСТЕМЫ SaaS backend / ecommerce backend / ticketing backend / document automation service
Задача сценария
Размещать QR codes в PDF documents, labels, receipts, tickets или forms, чтобы пользователи могли сканировать link, identifier или lookup token, который контролирует ваша система.
Когда использовать эту API
- В вашей системе есть URL, token, order ID, ticket ID или lookup value для encoding.
- Нужно нарисовать QR code в PDF, а не компоновать его как external bitmap.
- Нужны повторяемые QR-based layouts через Template Render.
- Нужен один API path для text, layout, PDF output и QR code rendering.
Что она не заменяет
- Нужны URL shortening, access-token issuance или payment-link creation от gPdf.
- Нужны scanner analytics или mobile app logic.
- Нужны QR codes вне PDF output.
Какой endpoint вызывать
/api/v1/pdf/render
JSON Render — путь по умолчанию для этого сценария.
/api/v1/template-render
Используйте, когда сценарию нужен связанный API-путь, контракт шаблона или проверка возможностей.
Минимальный запрос
POST /api/v1/pdf/render - document page с QR lookup code.
{
"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 barcode rendering внутри PDF output.
- Text, layout, receipt, ticket, label или document context вокруг QR code.
- Template binding для повторяемых QR workflows.
- Доставку PDF response через публичные render APIs.
Что контролирует ваша система
- Encoded URL или token, access control, expiry, redirect behavior и mobile destination.
- Scanner testing, user journey и fraud prevention rules.
- Любое payment, ticket, return или account action после сканирования.
Production-чеклист
- Держите encoded URLs стабильными или redirectable на весь lifetime документа.
- Проверяйте scan distance, contrast, size и print material.
- Не встраивайте sensitive raw data напрямую в QR payload.
- Используйте request IDs и логируйте business object, связанный с каждым generated PDF.
- Переносите стабильные QR layouts в Template Render.
Границы заявлений
- gPdf рендерит QR codes в PDF; он не хостит и не защищает destination.
- Ваша система отвечает за token expiry, redirects, permissions и scanner UX.
- QR code сам по себе не является payment или ticketing system.
QR code pages все равно требуют ясной семантики
QR code — только видимый носитель. Production workflow зависит от destination или token за ним. gPdf рисует QR code в PDF; ваша система отвечает за то, что происходит после сканирования.
FAQ
- Генерирует ли gPdf QR code images?
- gPdf рендерит QR code barcode elements внутри PDF output. Публичный response — PDF, а не standalone image service.
- Можно ли использовать QR codes в templates?
- Да. Template может содержать QR fields, а callers могут отправлять variable payload data.
- Кто отвечает за QR destination?
- Ваша система отвечает за URLs, tokens, redirects, permissions и expiry behavior.
- Может ли QR code содержать sensitive data?
- Он может закодировать все, что вы отправите, но production systems обычно должны кодировать lookup token или URL, а не raw sensitive data.