PDF417 Barcode API для PDF-документів і етикеток
Рендерте PDF417 штрихкоди в PDF для логістичних, квиткових, документних процесів і процесів у стилі boarding pass, поки ваша система відповідає за правила даних.
/api/v1/pdf/render Рендерити дані PDF417 штрихкоду як векторні PDF-елементи всередині етикеток, квитків, форм або документів у стилі boarding pass, поки ваша система відповідає за закодований формат і подальшу валідацію.
Коли використовувати цю API
- Потрібен PDF417 штрихкод, вбудований у PDF-документ або етикетку.
- Ваша система має фінально закодовані дані й знає вимоги сканерів, які споживатимуть результат.
- Потрібні повторювані макети PDF417 через Template Render.
- Потрібен PDF-вивід, а не окреме зображення штрихкоду.
Що вона не замінює
- Потрібно, щоб gPdf сертифікував формати даних авіакомпаній, державних, логістичних або галузевих систем.
- Потрібні облік квитків, призначення місць або логіка бронювання подорожей.
- Потрібне керування обладнанням сканерів.
Який шлях API викликати
/api/v1/pdf/render
JSON Render — типовий шлях для цього сценарію.
/api/v1/template-render
Використовуйте, коли сценарію потрібен пов’язаний API-шлях, контракт шаблону або перевірка можливостей.
Мінімальний запит
POST /api/v1/pdf/render - PDF417 штрихкод на сторінці у стилі ticket.
{
"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 штрихкоду всередині PDF-виводу.
- Макет документа або етикетки навколо штрихкоду.
- Прив’язку шаблону для повторюваних квиткових або логістичних макетів.
- Бінарну PDF-відповідь через публічні API рендерингу.
Що контролює ваша система
- Закодовані дані PDF417, галузеві правила, стан квитка або відправлення й ідентичність клієнта.
- Прийняття сканером, фізичне тестування друку й запобігання шахрайству.
- Будь-яку подальшу операцію бронювання, доступу або логістики, яку запускає штрихкод.
Чеклист для робочого запуску
- Валідуйте дані PDF417 у сканера або партнерської системи, що їх споживає.
- Друкуйте й скануйте в бойовому розмірі та на бойовому матеріалі.
- Не кладіть чутливі дані у штрихкод, якщо процес призначення цього не потребує.
- Використовуйте Template Render для затверджених повторюваних макетів.
- Логуйте request IDs разом із ID квитка, відправлення або документа.
Межі заявлених можливостей
- gPdf рендерить PDF417 штрихкоди; він не сертифікує галузеві формати даних.
- Семантика квитків, подорожей, ідентичності й логістики залишається вашою відповідальністю.
- Фізична валідація сканування все одно потрібна.
PDF417 — це штрихкод, а не бізнес-процес
PDF417 часто трапляється в квиткових, travel, identity і логістичних процесах. gPdf може рендерити штрихкод у PDF. Формат даних, перевірки ідентичності, стан бронювання й подальше прийняття залишаються поза API рендерингу.
FAQ
- Чи підтримує gPdf PDF417?
- Так. Публічний enum форматів штрихкодів містить aliases pdf417 і MicroPDF417.
- Чи може gPdf створювати дані для авіаційного boarding pass?
- Ні. gPdf рендерить значення PDF417, яке ви надсилаєте. Ваша система подорожей або квиткова система відповідає за побудову даних.
- Чи можна використовувати PDF417 з Template Render?
- Так. Використовуйте Template Render, коли повторюваний макет має приймати лише закодовані дані й бізнес-дані.
- Чи потрібно тестувати результат сканування?
- Так. PDF417-процеси потрібно валідувати сканерами, що споживатимуть результат, і бойовим друкарським матеріалом.