API de códigos de barras PDF417 para documentos y etiquetas PDF
Renderice códigos PDF417 en PDF para flujos de logística, tickets, documentos tipo tarjeta de embarque y documentos operativos, mientras su sistema controla las reglas de los datos codificados.
/api/v1/pdf/render Renderizar datos PDF417 como elementos vectoriales dentro de etiquetas, tickets, formularios o documentos tipo tarjeta de embarque, mientras su sistema controla el formato codificado y la validación aguas abajo.
Cuándo usar esta API
- Necesita un código de barras PDF417 incrustado en un documento o etiqueta PDF.
- Su sistema tiene los datos codificados finales y conoce los requisitos del escáner consumidor.
- Necesita diseños repetidos PDF417 mediante Template Render.
- Quiere salida PDF en lugar de una imagen de código de barras independiente.
Qué no sustituye
- Necesita que gPdf certifique formatos de datos de aerolínea, gobierno, logística o industria.
- Necesita inventario de tickets, asignación de asiento o lógica de reserva de viajes.
- Necesita gestión de hardware de escáneres.
Qué endpoint llamar
/api/v1/pdf/render
JSON Render es la ruta predeterminada para este flujo.
/api/v1/template-render
Úsalo cuando el flujo necesite la ruta API relacionada, un contrato de plantilla o una consulta de capacidades.
Solicitud mínima
POST /api/v1/pdf/render - código PDF417 en una página tipo 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
}
]
}
]
}
Qué gestiona gPdf
- Renderizado vectorial de códigos PDF417 dentro de la salida PDF.
- Diseño de documento o etiqueta alrededor del código de barras.
- Vinculación con plantillas para diseños repetidos de tickets o logística.
- Respuesta PDF binaria mediante las APIs públicas de renderizado.
Qué controla su sistema
- Datos PDF417 codificados, reglas sectoriales, estado del ticket o envío e identidad del cliente.
- Aceptación por escáner, pruebas físicas de impresión y prevención de fraude.
- Cualquier operación posterior de reserva, acceso o logística activada por el código de barras.
Checklist de producción
- Valide los datos PDF417 con el escáner o sistema socio que los consumirá.
- Imprima y escanee al tamaño y material de producción.
- No incluya datos sensibles en el código de barras salvo que el flujo de destino lo requiera.
- Use Template Render para diseños repetidos aprobados.
- Registre IDs de solicitud con el ID de ticket, envío o documento.
Límites de la promesa
- gPdf renderiza códigos PDF417; no certifica formatos de datos sectoriales.
- La semántica de tickets, viajes, identidad y logística sigue siendo su responsabilidad.
- La validación física de escaneo sigue siendo necesaria.
PDF417 es el código de barras, no el proceso empresarial
PDF417 aparece a menudo en flujos de tickets, viajes, identidad y logística. gPdf puede renderizar el código de barras en un PDF. El formato de los datos, las comprobaciones de identidad, el estado de reserva y la aceptación aguas abajo quedan fuera de la API de renderizado.
FAQ
- ¿gPdf soporta PDF417?
- Sí. El enum público de formatos de código de barras incluye alias pdf417 y MicroPDF417.
- ¿gPdf puede crear datos de tarjeta de embarque de aerolínea?
- No. gPdf renderiza el valor PDF417 que usted envía. Su sistema de viajes o tickets construye los datos codificados.
- ¿PDF417 puede usarse con Template Render?
- Sí. Use Template Render cuando un diseño repetido solo deba aceptar datos codificados y datos empresariales.
- ¿Necesito hacer pruebas de escaneo?
- Sí. Los flujos PDF417 deben validarse con los escáneres consumidores y el material de impresión de producción.