DataMatrix barcode API для векторного PDF output
Рендерьте DataMatrix и GS1 DataMatrix barcodes в PDF-этикетках и документах для product, medical, retail и warehouse workflows.
/api/v1/pdf/render Рендерить DataMatrix или GS1 DataMatrix payloads как векторные barcode elements внутри product labels, warehouse labels или documents, пока ваша система отвечает за encoded business payload.
Когда использовать эту API
- Нужен 2D DataMatrix barcode в PDF-документе или этикетке.
- Ваше приложение уже знает encoded identifier, lot, serial или product payload.
- Нужны повторяемые DataMatrix label layouts через Template Render.
- Нужен векторный barcode output вместо растровых изображений, встроенных в PDF.
Что она не заменяет
- Нужна regulatory certification, device labeling approval или GS1 certification от gPdf.
- Нужно, чтобы gPdf генерировал business identifiers или проверял external registries.
- Нужно управление scanner fleet.
Какой endpoint вызывать
/api/v1/pdf/render
JSON Render — путь по умолчанию для этого сценария.
/api/v1/template-render
Используйте, когда сценарию нужен связанный API-путь, контракт шаблона или проверка возможностей.
Минимальный запрос
POST /api/v1/pdf/render - GS1 DataMatrix barcode на product label.
{
"pages": [
{
"size": "label_100_100",
"elements": [
{
"type": "barcode",
"format": "gs1-datamatrix",
"content": "(01)09506000134352(10)LOT26A",
"x": 10,
"y": 14,
"width": 34,
"height": 34
},
{
"type": "text",
"x": 10,
"y": 56,
"content": "GTIN 09506000134352\nLOT LOT26A",
"style": { "font_size": 9, "font_family": "NotoSans-Regular" }
}
]
}
]
}
Что выполняет gPdf
- Векторный рендеринг DataMatrix и GS1 DataMatrix barcode в PDF.
- Layout этикетки или документа вокруг штрихкода.
- Template binding для повторяемых product или warehouse labels.
- Binary PDF output для печати, архива или download workflows.
Что контролирует ваша система
- Encoded payload content, application identifiers, serials, lots и regulatory text.
- Scanner testing, module size validation, label stock и acceptance criteria.
- Любой industry-specific compliance workflow, который потребляет barcode.
Production-чеклист
- Проверяйте payload syntax перед рендерингом.
- Печатайте и сканируйте в production size, DPI и material.
- Тестируйте длинные identifiers и несколько product-language variants.
- Держите certification и regulatory review вне gPdf.
- Используйте Template Render для утвержденных label families.
Границы заявлений
- gPdf рендерит DataMatrix barcodes; он не сертифицирует regulatory compliance.
- Ваша система отвечает за barcode payload semantics и scanner acceptance.
- Векторный рендеринг не заменяет physical print validation.
DataMatrix в PDF — это задача рендеринга
DataMatrix barcodes часто несут product или logistics identifiers. Важная граница — payload. gPdf рендерит векторный barcode из значения, которое вы отправляете; ваша система решает, что это значение означает и удовлетворяет ли оно внешним требованиям.
FAQ
- Поддерживает ли gPdf DataMatrix barcodes?
- Да. Публичная schema перечисляет aliases barcode formats для datamatrix и GS1 DataMatrix.
- Проверяет ли gPdf regulatory content?
- Нет. gPdf рендерит штрихкод. Ваша система отвечает за payload correctness и regulatory review.
- Можно ли использовать Template Render для DataMatrix labels?
- Да. Используйте Template Render, когда повторяемый label layout должен принимать только business data.
- Нужно ли все равно делать scan testing?
- Да. Всегда проверяйте результат с production printers, materials и scanners.