Adicionar código de barras ao PDF
Código de barras → Adicionar código de barras ao PDF
O Adicionar código de barras ao PDF API incorpora códigos de barras ou QR codes em seu PDFsVocê envia o PDF como Base64 (docContent), docName, o texto para codificar, barcodeType (por exemplo qrCode, code128, dataMatrix), páginas (ex.: 1-3 ou todos), alinhamento (alignX, alignY), e configurações opcionais de tamanho e margem. O API retorna o PDF Com o código de barras posicionado nas páginas selecionadas. Use o testador abaixo para experimentar; mais detalhes estão nas seções seguintes.
Experimente a opção Adicionar código de barras. PDF API
:::nota Referência rápida
Ponto final: POST /api/v2/addbarcode · Obrigatório: api-key, docContent, docName, texto, barcodeType, páginas, alignX, alignY, hideText
:::
Use o formulário abaixo para enviar sua API chave, PDF (Base64), conteúdo do código de barras, tipo, páginas de destino e alinhamento. A resposta é a versão modificada. PDF Com o código de barras incorporado. Nenhum código é necessário, preencha os campos e clique. Enviar solicitação.
Visão geral, parâmetros e casos de uso
- Overview
- Parameters
- Use cases
O que é adicionar um código de barras a PDF?
Este ponto de extremidade coloca um ou mais códigos de barras ou QR codes em páginas específicas de um PDFVocê escolhe o texto codificado e o tipo de código de barras (por exemplo, QR Code, Code128, DataMatrix), páginas de destino e posição por meio de alinhamento horizontal e vertical. Configurações opcionais controlam o tamanho (mm ou pontos), margens, opacitye se o texto legível por humanos aparece acima ou abaixo do código de barras.
Principais características
- Mais de 150 tipos de código de barrasIncluindo QR Code, Code128, DataMatrix, PDF417, Aztec, HanXin, Code39, EAN13/EAN8, UPC-A/UPC-E e muito mais.
- Posicionamento flexível: alignX (Esquerda, Centro, Direita) e alignY (Superior, Central, Inferior) com margens opcionais em milímetros ou pontos.
- Segmentação de página: Usar páginas (por exemplo
1-3,all) para adicionar o código de barras somente onde necessário. - Tamanho e opacidade: heightInMM / widthInMM ou heightInPt / widthInPt; opacity 0-100. Use 0 para dimensionamento automático, quando compatível.
Use para faturas, ingressos, etiquetas ou qualquer outra coisa PDF que precisa de códigos escaneáveis. Combine com Ler código de barras de PDF para verificar, ou Criar código de barras Se você precisar apenas de uma imagem de código de barras independente.
API parâmetros
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| api-key | corda | Sim | Seu PDF4me API chave, Base64 codificado. Obtenha-o do painel. |
| docContent | base64 | Sim | PDF conteúdo do arquivo (Base64). |
| docName | corda | Sim | Nome do arquivo de saída (ex.: output.pdf). |
| texto | corda | Sim | Texto a ser codificado no código de barras. |
| barcodeType | corda | Sim | Por exemplo qrCode, code128, dataMatrix, aztec, hanxin, pdf417, code39, ean13, ean8, upcA, upcE. |
| páginas | corda | Sim | Páginas de destino, por exemplo. 1-3 ou all. |
| alignX | corda | Sim | Alinhamento horizontal: Left, Center, Right. |
| alignY | corda | Sim | Alinhamento vertical: Top, Middle, Bottom. |
| hideText | booleano | Sim | Se deve ocultar ou não o texto legível do código de barras. |
| heightInMM, widthInMM | corda | Não | Tamanho em mm (0 = automático). |
| marginXInMM, marginYInMM | corda | Não | Margens em mm. |
| heightInPt, widthInPt | corda | Não | Tamanho em pontos. |
| marginXInPt, marginYInPt | corda | Não | Margens em pontos. |
| opacity | inteiro | Não | 0-100. |
| displayText | corda | Não | above ou below. |
| showOnlyInPrint, isTextAbove | booleano | Não | Visibilidade somente para impressão; texto acima do código de barras. |
| IsAsync | booleano | Não | Ativar o processamento assíncrono. |
Quando usar Adicionar código de barras para PDF
- Faturas e contas: Adicionar QR ou Code128 para pagamentos ou números de referência.
- Bilhetes e passes: Incorpore códigos para validação ou links.
- Rótulos e embalagensColoque os códigos de barras em PDFs Utilizado para impressão de etiquetas.
- Formulários e requerimentosAdicione identificadores únicos ou códigos de rastreamento a cada página.
- Processamento em lote: Usar páginas e alinhamento para adicionar códigos de barras consistentes em vários locais. PDFs.
Para esquemas de requisição/resposta e exemplos de código, consulte Adicionar código de barras ao PDF no PDF4me API documentos.
Pré-requisitos
Antes de usar este endpoint, certifique-se de que você possui:
- Um válido PDF4me API chave (Adquira o seu API Chave)
- A PDF documento em Base64 formato ou um público URL para um PDF arquivo
- O tipo de código de barras e o texto que você deseja codificar.
Formato de resposta
O API retorna um JSON responder com:
- Conteúdo do arquivoConteúdo binário do arquivo processado PDF documento com códigos de barras incorporados (Base64 codificado)
- Nome do arquivoNome do arquivo processado PDF documento