API kodów kreskowych PDF417 dla dokumentów i etykiet PDF
Renderuj kody PDF417 w PDF dla logistyki, biletów, dokumentów w stylu kart pokładowych i procesów dokumentowych, podczas gdy Twój system odpowiada za reguły danych.
/api/v1/pdf/render Renderuj dane PDF417 jako wektorowe elementy PDF wewnątrz etykiet, biletów, formularzy albo dokumentów w stylu kart pokładowych, podczas gdy Twój system odpowiada za zakodowany format i dalszą walidację.
Kiedy użyć tej API
- Potrzebujesz kodu kreskowego PDF417 osadzonego w dokumencie PDF albo etykiecie.
- Twój system ma finalne zakodowane dane i zna wymagania skanerów po stronie odbiorcy.
- Potrzebujesz powtarzalnych układów PDF417 przez Template Render.
- Chcesz wyjścia PDF zamiast samodzielnego obrazu kodu kreskowego.
Czego nie zastępuje
- Potrzebujesz, aby gPdf certyfikował formaty danych linii lotniczych, administracji, logistyki albo branży.
- Potrzebujesz inwentarza biletów, przydziału miejsc albo logiki rezerwacji podróży.
- Potrzebujesz zarządzania sprzętem skanującym.
Który endpoint wywołać
/api/v1/pdf/render
JSON Render to domyślna ścieżka dla tego procesu.
/api/v1/template-render
Użyj, gdy proces wymaga powiązanej ścieżki API, kontraktu szablonu albo sprawdzenia capabilities.
Minimalny request
POST /api/v1/pdf/render - kod PDF417 na stronie w stylu biletu.
{
"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
}
]
}
]
}
Co obsługuje gPdf
- Wektorowe renderowanie kodów PDF417 wewnątrz wyjścia PDF.
- Układ dokumentu albo etykiety wokół kodu kreskowego.
- Wiązanie szablonu dla powtarzalnych układów biletowych albo logistycznych.
- Binarną odpowiedź PDF przez publiczne API renderowania.
Co kontroluje Twój system
- Zakodowane dane PDF417, reguły branżowe, stan biletu albo przesyłki i tożsamość klienta.
- Akceptację skanerów, testy fizycznego wydruku i zapobieganie nadużyciom.
- Każdą dalszą operację rezerwacji, dostępu albo logistyki uruchamianą przez kod kreskowy.
Checklist produkcyjny
- Zweryfikuj dane PDF417 ze skanerem albo systemem partnerskim, który będzie je odczytywał.
- Drukuj i skanuj w produkcyjnym rozmiarze oraz na docelowym materiale.
- Nie umieszczaj danych wrażliwych w kodzie kreskowym, chyba że wymaga tego proces docelowy.
- Użyj Template Render dla zatwierdzonych powtarzalnych układów.
- Loguj request ID razem z identyfikatorem biletu, przesyłki albo dokumentu.
Granice deklaracji
- gPdf renderuje kody PDF417; nie certyfikuje branżowych formatów danych.
- Semantyka biletów, podróży, tożsamości i logistyki pozostaje po Twojej stronie.
- Fizyczna walidacja skanowania nadal jest wymagana.
PDF417 to kod kreskowy, nie proces biznesowy
PDF417 często pojawia się w procesach biletowych, podróżnych, tożsamościowych i logistycznych. gPdf może wyrenderować kod kreskowy w PDF. Format danych, kontrole tożsamości, stan rezerwacji i akceptacja po stronie odbiorcy pozostają poza Render API.
FAQ
- Czy gPdf obsługuje PDF417?
- Tak. Publiczny enum formatów kodów kreskowych obejmuje aliasy pdf417 i MicroPDF417.
- Czy gPdf może tworzyć dane kart pokładowych linii lotniczych?
- Nie. gPdf renderuje wartość PDF417, którą wyślesz. System podróży albo ticketingu odpowiada za zbudowanie danych.
- Czy PDF417 można używać z Template Render?
- Tak. Użyj Template Render, gdy powtarzalny układ ma przyjmować tylko dane do zakodowania i dane biznesowe.
- Czy muszę testować wynik skanowaniem?
- Tak. Procesy PDF417 należy weryfikować ze skanerami odbiorcy i produkcyjnym materiałem druku.