API V2

Adicionar código de barras ao PDF

Transforme seus documentos PDF com nossa poderosa API de código de barras que suporta mais de 150 tipos de códigos de barras, incluindo QR Code, Code128, DataMatrix, Aztec, Hanxin e PDF417. Perfeita para sistemas de inventário, etiquetas de envio, rastreamento de documentos e fluxos de trabalho automatizados.

Principais recursos:

  • 150+ tipos de códigos de barras: QR Code, Code128, DataMatrix, Aztec, Hanxin, PDF417 e mais
  • Posicionamento flexível: Coloque códigos de barras em qualquer lugar do seu PDF com controle preciso
  • Múltiplos formatos: Suporte para milímetros e pontos para dimensionamento exato
  • Opções de exibição de texto: Mostrar ou ocultar o texto do código de barras, posicionar acima ou abaixo
  • Controle de opacidade: Ajuste a transparência para efeitos de marca d’água
  • Processamento em lote: Adicione códigos de barras a várias páginas ou documentos

Casos de uso populares:

  • E-commerce: Catálogos de produtos com etiquetas de código de barras
  • Logística: Etiquetas de envio e documentos de rastreamento
  • Saúde: Registros de pacientes e administração de medicamentos
  • Governo: Documentos de identificação e formulários de conformidade
  • Educação: Carteirinhas de estudante e sistemas de biblioteca

Esta API geradora de códigos de barras integra-se perfeitamente aos seus fluxos de trabalho existentes, oferecendo confiabilidade e desempenho de nível empresarial.

  • Método: POST
  • Ponto final: /api/v2/addbarcode

Autenticar sua solicitação API

Para acessar a API Web do PDF4me, cada solicitação deve incluir credenciais de autenticação apropriadas. A autenticação garante uma comunicação segura e valida sua identidade como usuário autorizado.


Tipos de códigos de barras suportados

Nossa API de gerador de códigos de barras suporta 150+ tipos de códigos de barras, tornando-a a solução mais abrangente para integração de códigos de barras PDF.

Códigos de barras 1D (Lineares)

  • Code128: Código de barras 1D mais versátil, suporta todos os caracteres ASCII
  • Code39: Código de barras alfanumérico, amplamente usado em logística
  • EAN13/EAN8: Identificação internacional de produtos varejistas
  • UPC-A/UPC-E: Padrão varejista norte-americano
  • Code93: Versão aprimorada do Code39 com melhor densidade

Códigos de barras 2D (Matriz)

  • Código QR: Código de barras 2D mais popular para digitalização móvel
  • DataMatrix: Código de barras 2D de alta densidade, perfeito para itens pequenos
  • PDF417: Código de barras linear empilhado com grande capacidade de dados
  • Aztec: Código de barras 2D com excelente correção de erro
  • Hanxin: Padrão nacional chinês de código de barras 2D

PDF4me api samples

CSharp(C#)
Java
JavaScript
Python
Salesforce
Google Script
AWS Lambda

Parâmetros da API

Lista completa de parâmetros para a API Add Barcode to PDF. Os parâmetros são organizados por categoria para melhor compreensão e implementação.

Conteúdo do documentoBase64, Required

O conteúdo do documento PDF codificado em formato Base64. Este é o arquivo PDF de origem ao qual códigos de barras serão adicionados. O arquivo deve ser um documento PDF válido.

Exemplo:JVBERi0xLjQKJcOkw7zDtsO8CjIgMCBvYmoKPDwKL0xlbmd0aCAzIDAgUgo+PgpzdHJlYW0K...

Nome do documentostring, Required

O nome do arquivo PDF de origem. Deve incluir a extensão .pdf. Este nome será usado para referência e pode aparecer nas mensagens de erro.

Exemplos:

  • document.pdf
  • invoice-2024.pdf
  • report-final.pdf
Dados do código de barrasstring, Required

Os dados a serem codificados no código de barras. Pode ser texto, números, URLs ou qualquer string que o tipo de código de barras selecionado suporte. Os dados serão convertidos em uma imagem de código de barras escaneável.

Exemplos:

  • Texto:Hello World
  • URL:https://example.com
  • Código do produto:ABC123456
  • Telefone:+1-555-123-4567

Nota: Diferentes tipos de códigos de barras têm diferentes limites de capacidade de dados e restrições de caracteres.

Tipo de código de barrasstring, Required

Especifique o tipo de código de barras a ser gerado. Escolha entre mais de 150 formatos de códigos de barras suportados, incluindo códigos QR, códigos de barras lineares e códigos matriciais 2D.

Tipos populares:

  • Código QR:qrCode - Código de barras 2D mais versátil
  • Code128:code128 - Código de barras 1D universal
  • DataMatrix:dataMatrix - Código de barras 2D de alta densidade
  • EAN13:ean13 - Código de produto internacional
  • UPC-A:upcA - Padrão varejista norte-americano

Consulte a lista completa de tipos de códigos de barras suportados acima para todas as opções disponíveis.

Páginas alvostring, Required

Especifique quais páginas devem ter códigos de barras adicionados. Use seleção flexível de páginas com valores separados por vírgula e intervalos.

Exemplos de formato:

  • Todas as páginas:"" (string vazia)
  • Página única:"0" (primeira página)
  • Páginas múltiplas:"0, 2, 4"
  • Intervalo de páginas:"1-5" (páginas 2-6)
  • Misto:"0, 2-4, 7" (página 1, páginas 3-5, página 8)
  • Da página até o fim:"3-" (página 4 até o fim)

Nota: Os índices de página são baseados em 0 (primeira página = 0). Se não especificado, códigos de barras são adicionados a todas as páginas.

Alinhamento horizontalstring, Required

Controle o posicionamento horizontal do código de barras na página. Isso determina onde o código de barras aparece horizontalmente em relação às margens da página.

Opções:

  • Left - Alinhar à borda esquerda da página
  • Center - Centralizar horizontalmente na página
  • Right - Alinhar à borda direita da página

Exemplo:"Center" colocará o código de barras no meio da página horizontalmente.

Alinhamento verticalstring, Required

Controle o posicionamento vertical do código de barras na página. Isso determina onde o código de barras aparece verticalmente em relação às margens da página.

Opções:

  • Top - Alinhar à borda superior da página
  • Middle - Centralizar verticalmente na página
  • Bottom - Alinhar à borda inferior da página

Exemplo:"Bottom" colocará o código de barras na parte inferior da página verticalmente.

Altura do código de barras (mm)string, Required

Defina a altura do código de barras em milímetros. Isso controla o tamanho vertical do código de barras gerado.

Alturas recomendadas:

  • Códigos QR: 20-60mm (40mm recomendado)
  • Códigos de barras 1D: 15-30mm (20mm recomendado)
  • DataMatrix: 10-40mm (20mm recomendado)

Redimensionamento automático: Digite "0" para deixar o sistema determinar automaticamente a altura ótima baseada no tipo de código de barras e nos dados.

Exemplo:"40" cria um código de barras de 40mm de altura.

Largura em mmstring, Required

Largura do código de barras em milímetros. ‘0’ para detecção automática.
Exemplo - 40.

Margem horizontal em mmstring, Required

Margem do lado esquerdo da origem do código de barras em milímetros
Exemplo - 20

Margem vertical em mmstring, Required

Margem do topo da origem do código de barras em milímetros
Exemplo - 20

Altura em PtString, Required

Altura do código de barras em pontos (pt). ou ‘0’ para detecção automática.
Exemplo - 20.

Largura em PtString, Required

Largura do código de barras em pontos (pt). ou ‘0’ para detecção automática.
Exemplo - 20.

Margem X em PtString, Required

Margem da origem superior do código de barras em pontos (pt).
Exemplo - 10.

Margem Y em PtString, Required

Margem da origem esquerda do código de barras em pontos (pt).
Exemplo - 10.

Opacidadeinteger, Required

Dê um valor entre 0 e 100 onde ‘0’ é completamente transparente.
Exemplo - 100.

Mostrar textoString, Required

O texto será exibido -
acima
abaixo

Ocultar textoBoolean, Required

Selecione ‘true’ para ocultar o texto do código de barras e ‘false’ para exibi-lo junto ao código de barras.

  • true
  • false
Mostrar apenas na impressãoBoolean, Required

Se você quiser Mostrar apenas na impressão, mostrar apenas na impressão. Você pode escolher estas duas opções.
true
false

O texto está acimaBoolean, Required

Se você quiser O texto está acima, você pode escolher estas duas opções.
true
false


Saída

A API retorna o documento PDF processado com códigos de barras incorporados. A resposta inclui o conteúdo do arquivo e metadados para fácil integração em seu fluxo de trabalho de aplicação.

Conteúdo do arquivoBinary

Conteúdo binário do documento PDF processado com códigos de barras incorporados. Pronto para download ou processamento adicional.

Nome do arquivoString

Nome do arquivo para o documento PDF processado. Pode ser personalizado ou gerado automaticamente com base em seus requisitos.

Cabeçalho
Content-Type: application/json
Authorization: Por favor, copie a chave do link.

Payload

{
  "alignX": "Right",
  "alignY": "Top",
  "docContent": "Please put PDF base64 content",
  "docName": "output.pdf",
  "text": "hello",
  "barcodeType": "qrCode",
  "pages": "2",
  "heightInMM": "40",
  "widthInMM": "40",
  "marginXInMM": "20",
  "marginYInMM": "20",
  "heightInPt": "20",
  "widthInPt": "20",
  "marginXInPt": "10",
  "marginYInPt": "10",
  "opacity": 100,
  "displayText": "above",
  "hideText": true,
  "showOnlyInPrint": false,
  "isTextAbove": true
}

Casos de uso industriais e aplicações

E-commerce e varejo

  • Catálogos de produtos: Gerar códigos de barras para gestão de inventário e identificação de produtos
  • Etiquetas de preço: Criar preços dinâmicos com integração de códigos de barras para checkout automatizado
  • Rastreamento de pedidos: Adicionar códigos de rastreamento a documentos de envio para monitoramento em tempo real
  • Sistemas de inventário: Geração em massa de códigos de barras para gestão de armazém

Logística e envios

  • Etiquetas de envio: Adicionar códigos de barras de rastreamento a documentos de entrega
  • Rastreamento de pacotes: Gerar identificadores únicos para cada envio na cadeia de suprimentos
  • Gestão de armazém: Criar códigos de barras para localizações e identificação de produtos
  • Cadeia de suprimentos: Rastrear produtos através de toda a rede de distribuição

Saúde e médica

  • Registros de pacientes: Adicionar códigos de barras para identificação rápida de pacientes
  • Administração de medicamentos: Gerar códigos de barras para rastreamento de medicamentos
  • Equipamentos médicos: Etiquetar equipamentos com códigos de barras de manutenção
  • Resultados de laboratório: Adicionar códigos de barras a documentos de resultados

🏛️ Governo e conformidade

  • Documentos de identidade: Adicionar códigos de barras de segurança a licenças e passaportes
  • Documentos fiscais: Gerar códigos de rastreamento para formulários fiscais
  • Formulários de conformidade: Adicionar códigos de barras para rastreamento regulatório
  • Registros públicos: Criar identificadores de documentos pesquisáveis

🎓 Educação e bibliotecas

  • Cartões de estudante: Gerar códigos de barras para identificação de estudantes
  • Sistemas de biblioteca: Adicionar códigos de barras a livros e recursos
  • Documentos de exame: Criar identificadores únicos para testes
  • Serviços de campus: Rastrear uso de equipamentos e recursos

💼 Empresa e finanças

  • Processamento de faturas: Adicionar códigos de barras para processamento automatizado de faturas
  • Gestão de documentos: Criar identificadores únicos para documentos empresariais
  • Rastreamento de ativos: Gerar códigos de barras para equipamentos e ativos
  • Trilhas de auditoria: Adicionar códigos de rastreamento para documentação de conformidade