Штрихкоды и retail

PDF417 barcode API для PDF документов и labels

Рендерьте PDF417 barcodes в PDF для logistics, tickets, boarding-pass-style и document workflows, пока ваша система отвечает за payload rules.

ОСНОВНАЯ API JSON Render
ENDPOINT /api/v1/pdf/render
СИСТЕМЫ logistics backend / ticketing backend / travel workflow / document automation service
Задача сценария

Рендерить 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 — путь по умолчанию для этого сценария.

ДОПОЛНИТЕЛЬНЫЙ 1

/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-чеклист

  1. Проверьте PDF417 payload с consuming scanner или partner system.
  2. Печатайте и сканируйте в production size и material.
  3. Не помещайте sensitive data в barcode, если destination workflow этого не требует.
  4. Используйте Template Render для утвержденных повторяемых layouts.
  5. Логируйте 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.