API de código de barras PDF417 para documentos e etiquetas PDF
Renderize códigos de barras PDF417 em PDFs para fluxos de logística, tickets, documentos no estilo cartão de embarque e automação documental, enquanto seu sistema controla as regras dos dados codificados.
/api/v1/pdf/render Renderizar dados PDF417 como elementos vetoriais em PDF dentro de etiquetas, tickets, formulários ou documentos no estilo cartão de embarque, enquanto seu sistema controla o formato codificado e a validação downstream.
Quando usar esta API
- Você precisa de um código de barras PDF417 embutido em um documento ou etiqueta PDF.
- Seu sistema tem o conteúdo codificado final e conhece os requisitos dos scanners que vão consumi-lo.
- Você precisa de layouts PDF417 repetidos por Template Render.
- Você quer saída em PDF, não uma imagem isolada de código de barras.
O que ela não substitui
- Você precisa que o gPdf certifique formatos de dados de companhia aérea, governo, logística ou setor.
- Você precisa de inventário de tickets, atribuição de assentos ou lógica de reserva de viagem.
- Você precisa de gestão de hardware de scanner.
Qual endpoint chamar
/api/v1/pdf/render
JSON Render é o caminho padrão para este fluxo.
/api/v1/template-render
Use quando o fluxo precisar da API relacionada, de um contrato de template ou de uma consulta de capacidades.
Request mínimo
POST /api/v1/pdf/render - código de barras PDF417 em página no estilo 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
}
]
}
]
}
O que a gPdf faz
- Renderização vetorial de código de barras PDF417 dentro da saída em PDF.
- Layout de documento ou etiqueta ao redor do código de barras.
- Vinculação a modelo para layouts repetidos de tickets ou logística.
- Resposta binária em PDF pelas APIs públicas de renderização.
O que seu sistema controla
- Conteúdo codificado PDF417, regras do setor, estado do ticket ou envio e identidade do cliente.
- Aceite por scanner, testes físicos de impressão e prevenção de fraude.
- Qualquer operação downstream de reserva, acesso ou logística acionada pelo código de barras.
Checklist de produção
- Valide o conteúdo PDF417 com o scanner ou sistema parceiro que vai consumi-lo.
- Imprima e escaneie no tamanho e material de produção.
- Evite colocar dados sensíveis no código de barras, a menos que o fluxo de destino exija.
- Use Template Render para layouts repetidos aprovados.
- Registre IDs de requisição junto ao ID do ticket, envio ou documento.
Limites da promessa
- O gPdf renderiza códigos de barras PDF417; ele não certifica formatos de dados do setor.
- Semântica de ticket, viagem, identidade e logística continua sob sua responsabilidade.
- Validação física de leitura ainda é obrigatória.
PDF417 é o código de barras, não o processo de negócio
PDF417 aparece com frequência em fluxos de tickets, viagem, identidade e logística. O gPdf pode renderizar o código de barras em um PDF. O formato dos dados codificados, as verificações de identidade, o estado da reserva e o aceite downstream permanecem fora da API de renderização.
FAQ
- O gPdf oferece suporte a PDF417?
- Sim. O enum público de formatos de código de barras inclui aliases pdf417 e MicroPDF417.
- O gPdf pode criar dados de cartão de embarque de companhia aérea?
- Não. O gPdf renderiza o valor PDF417 que você envia. Seu sistema de viagem ou tickets controla a construção dos dados codificados.
- PDF417 pode ser usado com Template Render?
- Sim. Use Template Render quando um layout repetido deve aceitar apenas os dados codificados e dados de negócio.
- Preciso testar a leitura do resultado?
- Sim. Fluxos PDF417 devem ser validados com os scanners que vão consumi-los e com o material de impressão de produção.