Criar código de barras - QR Code Gerador API
PDF4me Criar código de barras permite que você crie códigos de barras independentes e QR code Imagens com suporte para mais de 150 tipos de código de barras, incluindo QR codes, Code128, DataMatrix, Aztec, Hanxin, PDF417e formatos especializados. Isto API O serviço gera imagens de código de barras compatíveis, otimizadas para impressão, leitura por dispositivos móveis e aplicações digitais. API recebe dados de texto e parâmetros de código de barras através de REST API chamadas, utilizando Base64 Codificação para transmissão segura. Essa solução é ideal para sistemas de gerenciamento de estoque, automação de etiquetagem de produtos e fluxos de trabalho de geração de códigos de barras corporativos.
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.
Principais características
- Biblioteca abrangente de códigos de barrasMais de 150 tipos de códigos de barras, incluindo QR codes, Code128, DataMatrix, Aztec, Hanxin, PDF417, códigos postais e simbologias industriais especializadas usando o parâmetro Tipo de Código de Barras
- Geração de imagens independenteCrie imagens de código de barras de alta qualidade de forma independente, sem a necessidade de documentos ou modelos existentes, através da especificação do nome do arquivo.
- Gerenciamento avançado de textoConfigure a exibição, o posicionamento e a visibilidade do texto do código de barras com opções de formatação profissional para uma apresentação clara usando o parâmetro Texto.
- Integração EmpresarialSimples API Com parâmetros mínimos projetados para integração perfeita em sistemas e fluxos de trabalho de negócios existentes, com mapeamento de parâmetros adequado.
REST API Ponto final
O PDF4me REST API usa padrão HTTP Métodos para interagir com recursos. Todas as operações de geração de código de barras são realizadas por meio de um único ponto de extremidade:
- Método: POST
- Ponto final:
/api/v2/CreateBarcode
Tipos de código de barras suportados
Suporta mais de 150 tipos de código de barras para geração abrangente de códigos de barras com base em JSON especificação.
Códigos de barras 1D populares
- Code128 - Código de barras universal (máximo de 255 caracteres) usando o parâmetro Tipo de código de barras
- Code39 - Código de barras alfanumérico (máximo de 43 caracteres) através do parâmetro Texto
- EAN13/EAN8 - Códigos de produtos de varejo (13/8 caracteres) com especificação de nome de arquivo
- UPC-A/UPC-E - Varejo norte-americano (12/8 caracteres) usando API integração
Códigos de barras 2D populares
- QR Code - Leitura móvel (máximo de 4.296 caracteres) usando o parâmetro Tipo de código de barras
- DataMatrix - 2D de alta densidade (máximo de 2.335 caracteres) através do parâmetro Texto
- PDF417 - Grande capacidade de dados (máximo de 2.710 caracteres) com especificação de nome de arquivo
- Aztec - Excelente correção de erros (máximo de 3.832 caracteres) usando API integração
Formatos especializados
- Códigos Postais: USPS, Royal Mail, Australia Post, Deutsche Post usando o parâmetro Tipo de código de barras
- Assistência médica: HIBC, GS1 DataBar, Pharmacode através do parâmetro Texto
- Logística: MaxiCode, SSCC-18, ITF-14, GS1-128 com especificação de nome de arquivo
- Variantes de QR: Micro QR, iQR, rMQR usando API integração
REST API Parâmetros
Lista completa de parâmetros para a função Criar Código de Barras 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 |
|---|---|---|---|
| texto* | String | Texto a ser codificado no código de barras. O comprimento do texto depende do tipo de código de barras. | PDF4me Create 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 |
| 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) | 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 Criar código de barras REST API Retorna respostas diferentes dependendo do modo de processamento. API retorna o código de barras como um arquivo de imagem binária (PNG formato), não como JSON.
- Success Response
- Asynchronous Processing
- Error Responses
- Response Format Details
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: image/png (ou formato de imagem apropriado)
Corpo da resposta: O corpo da resposta contém a imagem do código de barras como dados binários (PNG formato por padrão).
Como usar:
- Leia o corpo da resposta como dados binários.
- Salve os dados binários como um arquivo de imagem (por exemplo, .png, .jpg).
- Utilize o arquivo de imagem conforme necessário.
Exemplo (JavaScript):
const response = await fetch(url, options);
const blob = await response.blob();
const url = URL.createObjectURL(blob);
// Use the URL to display or download the image
Exemplo (Python):
response = requests.post(url, json=payload, headers=headers)
if response.status_code == 200:
with open('barcode.png', 'wb') as f:
f.write(response.content)
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/CreateBarcode/poll/12345-abcde-67890
Processo de votação:
- Extraia o
Locationcabeçalho da resposta 202 - Faça a pesquisa URL usando GET solicitações
- Continue votando até receber um 200 OK status
- A resposta final contém a imagem do código de barras como dados binários (PNG formato)
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 blob = await pollResponse.blob();
// Process blob (barcode image)
break;
}
await new Promise(resolve => setTimeout(resolve, 2000)); // Wait 2 seconds
}
Respostas de erro
O API retorna padrão HTTP Códigos de erro com detalhes do erro:
- Parâmetros de solicitação inválidos
- Campos obrigatórios ausentes (
texto,tipo de código de barras,ocultarTexto,assíncrono) - Tipo de código de barras inválido
- O comprimento do texto excede a capacidade do tipo de código de barras.
- Inválido ou ausente API chave
- API chave não está correta Base64 codificado em Authorization cabeçalho
- Ausente
AuthorizationBásicocabeçalho
- Erro de processamento no servidor
- Falha na geração do código de barras
Formato da resposta de erro:
{
"error": "Error message describing what went wrong"
}
Detalhes do formato da resposta
Importante: O API retorna dados de imagem binários (PNG formato por padrão), não JSON.
Estrutura da resposta:
- Content-Type:
image/png(ou tipo MIME de imagem apropriado) - Corpo de RespostaDados de imagem binária
Formato da imagem:
- Formato padrão: PNG
- A imagem do código de barras está pronta para uso direto, download ou integração.
Salvando a imagem:
JavaScript/Node.js:
const response = await fetch(url, options);
const blob = await response.blob();
const url = URL.createObjectURL(blob);
const a = document.createElement('a');
a.href = url;
a.download = 'barcode.png';
a.click();
Python:
response = requests.post(url, json=payload, headers=headers)
if response.status_code == 200:
with open('barcode.png', 'wb') as f:
f.write(response.content)
C#:
var response = await httpClient.PostAsync(url, content);
if (response.IsSuccessStatusCode)
{
var imageBytes = await response.Content.ReadAsByteArrayAsync();
await File.WriteAllBytesAsync("barcode.png", imageBytes);
}
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 usarAuthorization: Basic YWJjMTIz
Carga útil
Exemplo:
{
"text": "PDF4me Create Barcode Sample",
"barcodeType": "qrCode",
"hideText": false,
"async": true
}
Exemplos de código
O PDF4me Criar código de barras 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#
- Java
- JavaScript
- Python
- Salesforce
- n8n
- Google Script
- AWS Lambda
Java Amostra
Java Implementação com tratamento completo de erros e processamento de respostas:
JavaScript Amostra
Node.js e compatível com navegadores JavaScript Implementação:
Google Script Amostra
Google Apps Script implementação para Google Workspace integração:
Casos de uso e aplicações industriais
- E-commerce & Retail
- Logistics & Shipping
- Healthcare & Medical
- Government & Compliance
- Education & Libraries
- Business & Finance
Casos de uso de comércio eletrônico e varejo
- Rótulos de produtosGere imagens de código de barras independentes para embalagens e rótulos de produtos usando o parâmetro Tipo de Código de Barras.
- Etiquetas de preçoCrie imagens de código de barras para sistemas de precificação dinâmica e finalização de compra automatizada por meio do parâmetro Texto.
- Gestão de estoqueGere imagens de código de barras para gerenciamento de armazém e controle de estoque com especificação de nome de arquivo.
- Catálogos de produtosCrie imagens de código de barras para identificação de produtos e sistemas de catálogo usando API integração
Casos de uso em logística e transporte
- Etiquetas de envioGere imagens de código de barras independentes para rastreamento e entrega de pacotes usando o parâmetro Tipo de Código de Barras.
- Identificação da embalagemCrie imagens de código de barras exclusivas para cada remessa em toda a cadeia de suprimentos por meio do parâmetro de texto.
- Sistemas de ArmazémGere imagens de código de barras para localização de produtos e rastreamento de estoque com especificação de nome de arquivo.
- Cadeia de mantimentosCrie imagens de código de barras para rastreamento de produtos em redes de distribuição usando API integração
Casos de uso na área da saúde e medicina
- Identificação do PacienteGere imagens de código de barras para pulseiras de pacientes e registros médicos usando o parâmetro Tipo de Código de Barras.
- Rastreamento de medicamentosCriar imagens de código de barras para identificação de medicamentos e verificação de dosagem por meio do parâmetro Texto.
- Gestão de EquipamentosGere imagens de código de barras para equipamentos médicos e rastreamento de ativos com especificação de nome de arquivo.
- Rastreamento de amostras de laboratórioCrie imagens de código de barras para amostras de teste e identificação de resultados usando API integração
Casos de uso para governo e conformidade
- Documentos de IdentificaçãoGere imagens de código de barras para carteiras de habilitação, passaportes e documentos de identidade usando o parâmetro Tipo de Código de Barras.
- Processamento de formuláriosCrie imagens de código de barras para formulários fiscais e documentação de conformidade por meio do parâmetro Texto.
- Rastreamento de DocumentosGere imagens de código de barras para rastreamento regulatório e trilhas de auditoria com especificação de nome de arquivo.
- Registros PúblicosCrie imagens de código de barras para sistemas de identificação de documentos governamentais usando API integração
Casos de uso em educação e bibliotecas
- Carteiras de estudanteGere imagens de código de barras para identificação de alunos e acesso ao campus usando o parâmetro Tipo de Código de Barras.
- Sistemas de BibliotecaCriar imagens de código de barras para identificação de livros e sistemas de empréstimo através do parâmetro Texto.
- Segurança do exameGere imagens de código de barras para identificação e verificação de integridade de documentos de teste com especificação de nome de arquivo.
- Serviços do CampusCrie imagens de código de barras para rastreamento de equipamentos e recursos usando API integração
Casos de uso em negócios e finanças
- Sistemas de FaturamentoGere imagens de código de barras para processamento e pagamento automatizado de faturas usando o parâmetro Tipo de Código de Barras.
- Gestão de DocumentosCrie imagens de código de barras para identificação de documentos comerciais por meio do parâmetro Texto.
- Rastreamento de ativosGere imagens de código de barras para sistemas de gerenciamento de equipamentos e ativos com especificação de nome de arquivo.
- Documentação de ConformidadeCrie imagens de código de barras para trilhas de auditoria e registros financeiros usando API integração