PDF417 barcode API для PDF документов и labels
Рендерьте PDF417 barcodes в PDF для logistics, tickets, boarding-pass-style и document workflows, пока ваша система отвечает за payload rules.
/api/v1/pdf/render Рендерить PDF417 barcode payloads как векторные PDF elements внутри labels, tickets, forms или boarding-pass-style documents, пока ваша система отвечает за encoded format и downstream validation.
Когда использовать эту API
- Нужен PDF417 barcode, встроенный в PDF document или label.
- В вашей системе уже есть final encoded payload и понимание downstream scanner requirements.
- Нужны повторяемые PDF417 layouts через Template Render.
- Нужен PDF output, а не standalone barcode image.
Что она не заменяет
- Нужно, чтобы gPdf сертифицировал airline, government, logistics или industry payload formats.
- Нужны ticket inventory, seat assignment или travel booking logic.
- Нужно управление scanner hardware.
Какой endpoint вызывать
/api/v1/pdf/render
JSON Render — путь по умолчанию для этого сценария.
/api/v1/template-render
Используйте, когда сценарию нужен связанный API-путь, контракт шаблона или проверка возможностей.
Минимальный запрос
POST /api/v1/pdf/render - PDF417 barcode на ticket-style page.
{
"pages": [
{
"size": "a6",
"elements": [
{
"type": "text",
"x": 10,
"y": 14,
"content": "Boarding pass sample",
"style": { "font_size": 14, "font_family": "NotoSans-Regular" }
},
{
"type": "barcode",
"format": "pdf417",
"content": "M1DOE/JOHN EABC123 JFKLAX GP 042 001A0001 100",
"x": 10,
"y": 38,
"width": 80,
"height": 28
}
]
}
]
}
Что выполняет gPdf
- Векторный PDF417 barcode rendering внутри PDF output.
- Document или label layout вокруг штрихкода.
- Template binding для повторяемых ticket или logistics layouts.
- Binary PDF response через публичные render APIs.
Что контролирует ваша система
- Encoded PDF417 payload, industry rules, ticket или shipment state и customer identity.
- Scanner acceptance, physical print testing и fraud prevention.
- Любую downstream booking, access или logistics operation, triggered by the barcode.
Production-чеклист
- Проверьте PDF417 payload с consuming scanner или partner system.
- Печатайте и сканируйте в production size и material.
- Не помещайте sensitive data в barcode, если destination workflow этого не требует.
- Используйте Template Render для утвержденных повторяемых layouts.
- Логируйте request IDs вместе с ticket, shipment или document ID.
Границы заявлений
- gPdf рендерит PDF417 barcodes; он не сертифицирует industry payload formats.
- Ticketing, travel, identity и logistics semantics остаются на вашей стороне.
- Physical scan validation все равно требуется.
PDF417 — это barcode, а не business process
PDF417 часто используется в ticket, travel, identity и logistics workflows. gPdf может отрендерить штрихкод в PDF. Payload format, identity checks, booking state и downstream acceptance остаются вне render API.
FAQ
- Поддерживает ли gPdf PDF417?
- Да. Public barcode format enum включает aliases `pdf417` и MicroPDF417.
- Может ли gPdf создавать airline boarding pass payloads?
- Нет. gPdf рендерит PDF417 value, который вы отправляете. Ваша travel или ticketing system отвечает за payload construction.
- Можно ли использовать PDF417 с Template Render?
- Да. Используйте Template Render, когда повторяемый layout должен принимать только payload и business data.
- Нужно ли scan-test результата?
- Да. PDF417 workflows следует проверять с consuming scanners и production print material.