Adicionar código de barras ao PDF - QR Code Integração API

PDF4me Adicionar código de barras ao PDF permite adicionar códigos de barras profissionais e QR codes para PDF documentos com controles precisos de posicionamento, dimensionamento e formatação. Isto API processos de serviço PDF arquivos e adiciona códigos de barras usando Base64 Codificação para transmissão segura. Com suporte para mais de 150 tipos de código de barras, incluindo QR codes, Code128, DataMatrix, Aztec, Hanxin, PDF417Com sua ampla gama de recursos e formatos especializados, essa solução é ideal para sistemas de gerenciamento de estoque, automação de etiquetas de envio, fluxos de trabalho de rastreamento de documentos e integração de códigos de barras corporativos.

Artigos relacionados no blogue(1)

Está com dificuldades para adicionar códigos de barras a PDFs? Aqui está a solução completa!

Um guia prático para adicionar códigos de barras e códigos QR a documentos PDF programaticamente. Aprenda sobre tipos de códigos de barras, estratégias de posicionamento e padrões de implementação no mundo real.

Ler publicação →

Autenticando seu API Solicitar

Para acessar o PDF4me REST APIPara que uma solicitação seja aceita, é necessário incluir as credenciais de autenticação adequadas. A autenticação garante a segurança da comunicação e valida sua identidade como usuário autorizado do sistema. REST API.

Get your api Key

Principais características

• Suporte completo para códigos de barrasMais de 150 tipos de códigos de barras, incluindo QR codes, Code128, DataMatrix, Aztec, Hanxin, PDF417, códigos postais e formatos industriais especializados
• Controle de posicionamento precisoColoque os códigos de barras em qualquer lugar na PDF Páginas com precisão perfeita em pixels, utilizando sistemas de medição tanto em milímetros quanto em pontos.
• Opções avançadas de dimensionamentoDimensões flexíveis de código de barras com recursos de dimensionamento automático e controles personalizados de largura/altura para um desempenho de leitura ideal.
• Gestão profissional de textosConfigure a exibição, o posicionamento (acima/abaixo) e a visibilidade do texto do código de barras com opções de formatação personalizáveis.
• Opacidade e TransparênciaAjuste os níveis de transparência do código de barras para efeitos de marca d'água, sobreposições em documentos e apresentações profissionais.
• Processamento em lote empresarialAdicione códigos de barras a várias páginas, documentos ou coleções inteiras de documentos com fluxos de trabalho de processamento automatizados.

REST API Ponto final

O PDF4me REST API usa padrão HTTP Métodos para interagir com recursos. Todas as operações de código de barras são realizadas por meio de um único ponto de extremidade:

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

Tipos de código de barras suportados

Suporta mais de 150 tipos de código de barras para uma identificação completa. PDF integração.

Códigos de barras 1D populares

• Code128 - Código de barras universal (máximo de 255 caracteres)
• Code39 - Código de barras alfanumérico (máximo de 43 caracteres)
• EAN13/EAN8 - Códigos de produtos de varejo (13/8 caracteres)
• UPC-A/UPC-E - Varejo norte-americano (12/8 caracteres)

Códigos de barras 2D populares

• QR Code - Digitalização móvel (máximo de 4.296 caracteres)
• DataMatrix - 2D de alta densidade (máximo de 2.335 caracteres)
• PDF417 - Grande capacidade de dados (máximo de 2.710 caracteres)
• Aztec - Excelente correção de erros (máximo de 3.832 caracteres)

Formatos especializados

• Códigos Postais: USPS, Royal Mail, Australia Post, Deutsche Post
• Assistência médica: HIBC, GS1 DataBar, Pharmacode
• Logística: MaxiCode, SSCC-18, ITF-14, GS1-128
• Variantes de QR: Micro QR, iQR, rMQR

REST API Parâmetros

Lista completa de parâmetros para Adicionar código de barras. PDF REST APIOs parâmetros estão organizados por categoria para melhor compreensão e implementação.

Importante: Os parâmetros marcados com um asterisco (*) são obrigatórios e devem ser fornecidos para o API para funcionar corretamente.

Parâmetros obrigatórios

Parâmetro	Tipo	Descrição	Exemplo
docName*	String	Saída PDF nome do arquivo com extensão .pdf	output.pdf
docContent*	Base64	O conteúdo da entrada PDF arquivo codificado em Base64	JVBERi...
texto*	String	Texto a ser codificado no código de barras. O comprimento do texto depende do tipo de código de barras.	PDF4me Barcode Sample
barcodeType*	String	Tipo de formato de código de barras. Opções: qrCode, code128, dataMatrix, aztec, hanxin, pdf417, code39, ean13, ean8, upcA, upcE	qrCode
páginas*	String	Páginas de destino (por exemplo, "1-3", "todas", "1", "1,3,5", "2-5", "1,3,7-10", "2-")	1-3
alignX*	String	Alinhamento horizontal: Esquerda, Centro, ou Certo	Right
alignY*	String	Alinhamento vertical: Principal, Meio, ou Fundo	Bottom
hideText*	Boolean	Ocultar o rótulo de texto do código de barras (verdadeiro = ocultar, falso = mostrar o texto ao lado do código de barras)	true

Parâmetros opcionais

Parâmetro	Tipo	Descrição	Exemplo
heightInMM	String	Altura do código de barras em milímetros (0 = automático)	40
widthInMM	String	Largura do código de barras em milímetros (0 = automático)	40
marginXInMM	String	Margem horizontal em milímetros	20
marginYInMM	String	Margem vertical em milímetros	20
heightInPt	String	Altura do código de barras em pontos	113
widthInPt	String	Largura do código de barras em pontos	113
marginXInPt	String	Margem horizontal em pontos	57
marginYInPt	String	Margem vertical em pontos	57
opacity	Integer	Nível de transparência (0-100): 0 = invisível, 100 = totalmente opaco	100
displayText	String	Posição do texto: acima ou abaixo	below
showOnlyInPrint	Boolean	Mostrar apenas na versão impressa (verdadeiro) ou na versão visual e impressa (falso)	false
isTextAbove	Boolean	Texto acima do código de barras (verdadeiro) ou abaixo (falso)	false
async	Boolean	Ative o processamento assíncrono. Quando true, o API retorna o status 202 e fornece uma opção de sondagem. URL no Location cabeçalho	true

Saída

O PDF4me Adicionar código de barras ao PDF REST API Retorna respostas diferentes dependendo do modo de processamento. API retorna o PDF como um Base64string codificada em JSON formato, não como dados binários.

Success Response

Processamento síncrono (padrão)

Quando async não está definido ou está definido como false, o API processa a solicitação imediatamente:

Código de status: 200 OK

Content-Type: application/json

Corpo da resposta:

{
  "docName": "output.pdf",
  "docContent": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPD4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA2MTIgNzkyXQovUmVzb3VyY2VzIDw8Ci9Gb250IDw8Ci9GMSA0IDAgUgo+Pgo+PgovQ29udGVudHMgNSAwIFIKPj4KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL0ZvbnQKL1N1YnR5cGUgL1R5cGUxCi9CYXNlRm9udCAvSGVsdmV0aWNhCj4+CmVuZG9iago1IDAgb2JqCjw8Ci9MZW5ndGggNDQKPj4Kc3RyZWFtCkJUCi9GMSAxMiBUZgoxMDAgNzAwIFRkCihIZWxsbyBXb3JsZCkgVGoKRVQKZW5kc3RyZWFtCmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1NCAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAxNzAgMDAwMDAgbiAKMDAwMDAwMDI0NCAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9TaXplIDYKL1Jvb3QgMSAwIFIKPj4Kc3RhcnR4cmVmCjM0MQolJUVPRg=="
}

Campos de resposta:

• docName (string): A saída PDF nome do arquivo
• docContent (string): O PDF Arquivo com código de barras adicionado, codificado como Base64 corda

Como usar:

1. Extraia o docContent campo do JSON resposta
2. Decifre o Base64 string para obter o binário PDF dados
3. Salvar ou processar o PDF arquive conforme necessário

Exemplo (JavaScript):

const response = await fetch(url, options);
const data = await response.json();
const pdfBytes = atob(data.docContent); // Decode Base64
// Save or process pdfBytes

Asynchronous Processing

Processamento assíncrono

Quando async: true está definido, o API processa a solicitação de forma assíncrona:

Código de status: 202 Accepted

Cabeçalhos de resposta:

Location: https://api.pdf4me.com/api/v2/addbarcode/poll/12345-abcde-67890

Processo de votação:

1. Extraia o Location cabeçalho da resposta 202
2. Faça a pesquisa URL usando GET solicitações
3. Continue votando até receber um 200 OK status
4. A resposta final contém o mesmo JSON formato com docName e docContent (Base64)

Exemplo de votação:

// Initial request returns 202 with Location header
const response = await fetch(url, options);
const location = response.headers.get('Location');

// Poll until complete
while (true) {
  const pollResponse = await fetch(location, { headers: { 'Authorization': 'Basic ' + apiKey } });
  if (pollResponse.status === 200) {
    const data = await pollResponse.json();
    // Process data.docContent (Base64 PDF)
    break;
  }
  await new Promise(resolve => setTimeout(resolve, 2000)); // Wait 2 seconds
}

Error Responses

Respostas de erro

O API retorna padrão HTTP Códigos de erro com detalhes do erro:

400 Bad Request

• Parâmetros de solicitação inválidos
• Campos obrigatórios ausentes
• Inválido Base64 codificação em docContent
• Tipo de código de barras inválido
• Valores de alinhamento inválidos

401 Unauthorized

• Inválido ou ausente API chave
• API chave não está corretamente Base64 codificado em Authorization cabeçalho
• Ausente AuthorizationBásico cabeçalho

500 Internal Server Error

• Erro de processamento no servidor
• PDF falha de processamento
• Falha na geração do código de barras

Formato da resposta de erro:

{
  "error": "Error message describing what went wrong"
}

Response Format Details

Detalhes do formato da resposta

Importante: O API sempre retorna JSON, nunca binário PDF dados diretamente.

Estrutura da resposta:

{
  "docName": "string",      // Output PDF filename
  "docContent": "string"    // Base64-encoded PDF content
}

Content-Type Cabeçalho:

• Sucesso: application/json
• O PDF está incorporado como um Base64 string dentro do JSON resposta

Por que Base64?

• JSON-Codificação segura para dados binários
• Fácil de transmitir HTTP
• Compatível com todas as linguagens de programação.
• Pode ser incorporado diretamente em JSON sem escapar dos problemas

Decodificando Base64 para PDF:

JavaScript/Node.js:

const base64 = response.docContent;
const binary = atob(base64); // Browser
// OR
const binary = Buffer.from(base64, 'base64').toString('binary'); // Node.js

Python:

import base64
pdf_bytes = base64.b64decode(response['docContent'])
with open('output.pdf', 'wb') as f:
    f.write(pdf_bytes)

C#:

byte[] pdfBytes = Convert.FromBase64String(response.docContent);
File.WriteAllBytes("output.pdf", pdfBytes);

Exemplo de solicitação

Cabeçalho

Content-Type: application/json
Authorization: Basic YOUR_BASE64_ENCODED_API_KEY

Observação:

• Adquira o seu API chave do PDF4me Painel
• O API a chave deve ser Base64 codificado e prefixado com "Básico" no Authorization cabeçalho
• Exemplo: Se o seu API chave é abc123, codifique-o para Base64 e usar Authorization: Basic YWJjMTIz

Carga útil

Exemplo básico (somente campos obrigatórios):

{
  "docName": "output.pdf",
  "docContent": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPD4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA2MTIgNzkyXQovUmVzb3VyY2VzIDw8Ci9Gb250IDw8Ci9GMSA0IDAgUgo+Pgo+PgovQ29udGVudHMgNSAwIFIKPj4KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL0ZvbnQKL1N1YnR5cGUgL1R5cGUxCi9CYXNlRm9udCAvSGVsdmV0aWNhCj4+CmVuZG9iago1IDAgb2JqCjw8Ci9MZW5ndGggNDQKPj4Kc3RyZWFtCkJUCi9GMSAxMiBUZgoxMDAgNzAwIFRkCihIZWxsbyBXb3JsZCkgVGoKRVQKZW5kc3RyZWFtCmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1NCAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAxNzAgMDAwMDAgbiAKMDAwMDAwMDI0NCAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9TaXplIDYKL1Jvb3QgMSAwIFIKPj4Kc3RhcnR4cmVmCjM0MQolJUVPRg==",
  "text": "PDF4me Barcode Sample",
  "barcodeType": "qrCode",
  "pages": "1-3",
  "alignX": "Right",
  "alignY": "Bottom",
  "hideText": true
}

Exemplo avançado (com todos os campos opcionais):

{
  "docName": "output.pdf",
  "docContent": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPD4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA2MTIgNzkyXQovUmVzb3VyY2VzIDw8Ci9Gb250IDw8Ci9GMSA0IDAgUgo+Pgo+PgovQ29udGVudHMgNSAwIFIKPj4KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL0ZvbnQKL1N1YnR5cGUgL1R5cGUxCi9CYXNlRm9udCAvSGVsdmV0aWNhCj4+CmVuZG9iago1IDAgb2JqCjw8Ci9MZW5ndGggNDQKPj4Kc3RyZWFtCkJUCi9GMSAxMiBUZgoxMDAgNzAwIFRkCihIZWxsbyBXb3JsZCkgVGoKRVQKZW5kc3RyZWFtCmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1NCAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAxNzAgMDAwMDAgbiAKMDAwMDAwMDI0NCAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9TaXplIDYKL1Jvb3QgMSAwIFIKPj4Kc3RhcnR4cmVmCjM0MQolJUVPRg==",
  "text": "PDF4me Barcode Sample",
  "barcodeType": "qrCode",
  "pages": "1-3",
  "alignX": "Right",
  "alignY": "Bottom",
  "hideText": true,
  "heightInMM": "40",
  "widthInMM": "40",
  "marginXInMM": "20",
  "marginYInMM": "20",
  "heightInPt": "113",
  "widthInPt": "113",
  "marginXInPt": "57",
  "marginYInPt": "57",
  "opacity": 100,
  "displayText": "below",
  "showOnlyInPrint": false,
  "isTextAbove": false,
  "async": true
}

Exemplos de código

O PDF4me Adicionar código de barras ao PDF REST API Fornece exemplos de código em várias linguagens de programação. Escolha a linguagem que melhor se adapta ao seu ambiente de desenvolvimento:

C#

C# (CSharp) Amostra

Completo C# implementação para adicionar códigos de barras a PDF documentos:

View C# Sample

Java

Java Amostra

Java Implementação com tratamento completo de erros e processamento de respostas:

View Java Sample

JavaScript

JavaScript Amostra

Node.js e compatível com navegadores JavaScript Implementação:

View JavaScript Sample

Python

Python Amostra

Python implementação com a biblioteca requests e JSON manuseio:

View Python Sample

Salesforce

Salesforce Amostra

Salesforce Apex implementação para CRM integração:

View Salesforce Sample

Google Script

Google Script Amostra

Google Apps Script implementação para Google Workspace integração:

View Google Script Sample

n8n

n8n Amostra

n8n Implementação de fluxo de trabalho para automação:

View n8n Sample

AWS Lambda

AWS Lambda Amostra

Sem servidor AWS Lambda Implementação da função:

View AWS Lambda Sample

Casos de uso e aplicações industriais

E-commerce & Retail

Casos de uso de comércio eletrônico e varejo

• Catálogos de produtosGere códigos de barras para gerenciamento de estoque e identificação de produtos.
• Etiquetas de preçoCrie preços dinâmicos com integração de código de barras para finalização de compra automatizada.
• Rastreamento de PedidosAdicione códigos de rastreamento aos documentos de envio para monitoramento de pacotes em tempo real.
• Sistemas de inventárioGeração em massa de códigos de barras para gerenciamento de armazém e controle de estoque.

Logistics & Shipping

Casos de uso em logística e transporte

• Etiquetas de envioAdicionar códigos de barras de rastreamento aos documentos de entrega para rastreabilidade da encomenda.
• Rastreamento de PacotesGere identificadores únicos para cada remessa em toda a cadeia de suprimentos.
• Gestão de ArmazémCriar códigos de barras para localização de produtos e identificação de produtos.
• Cadeia de mantimentosRastreie produtos em toda a rede de distribuição com códigos incorporados.

Healthcare & Medical

Casos de uso na área da saúde e medicina

• Registros de pacientesAdicione códigos de barras para facilitar a identificação do paciente e o acesso ao histórico médico.
• Administração de medicamentosGere códigos de barras para rastreamento de medicamentos e verificação de dosagem.
• Equipamentos médicosIdentificar equipamentos com códigos de barras de manutenção para gestão de ativos.
• Resultados de laboratórioAdicionar códigos de barras aos documentos de resultados de exames para vinculação segura de dados do paciente.

Government & Compliance

Casos de uso para governo e conformidade

• Documentos de IdentificaçãoAdicionar códigos de barras de segurança às carteiras de habilitação e passaportes para verificação.
• Documentos FiscaisGere códigos de rastreamento para formulários fiscais e monitoramento de conformidade.
• Formulários de conformidadeAdicionar códigos de barras para rastreamento regulatório e trilhas de auditoria.
• Registros PúblicosCriar identificadores de documentos pesquisáveis para bancos de dados governamentais.

Education & Libraries

Casos de uso em educação e bibliotecas

• Carteiras de estudanteGerar códigos de barras para identificação de estudantes e controle de acesso ao campus.
• Sistemas de BibliotecaAdicionar códigos de barras a livros e recursos para sistemas de empréstimo automatizados.
• Provas de exameCriar identificadores únicos para documentos de teste e integridade acadêmica.
• Serviços do CampusMonitorar o uso de equipamentos e recursos em instalações educacionais.

Business & Finance

Casos de uso em negócios e finanças

• Processamento de faturasAdicionar códigos de barras para processamento automatizado de faturas e pagamentos.
• Gestão de DocumentosCriar identificadores únicos para documentos e registros comerciais.
• Rastreamento de ativosGere códigos de barras para equipamentos e ativos em toda a organização.
• Trilhas de auditoriaAdicionar códigos de rastreamento para documentação de conformidade e registros financeiros.

Obtenha ajuda

Get Your API KeyAPI SamplesGetting Started