Ler código de barras de PDF - Scanner e Extrator API
PDF4me Ler código de barras de PDF Permite extrair e reconhecer vários tipos de códigos de barras e QR codes de PDF documentos usando recursos avançados OCR e tecnologia de reconhecimento de código de barras. Isto API processos de serviço PDF O sistema processa e extrai dados de código de barras com coordenadas de posição, informações de tipo e texto extraído. API recebe PDF conteúdo através de REST API chamadas, utilizando Base64 Codificação para transmissão segura. Com suporte para códigos de barras 1D e 2D, incluindo QR codes, DataMatrix, PDF417, Code128Com formatos especializados para diversos setores, essa solução é ideal para processamento de documentos, gestão de estoque, sistemas de rastreamento e automação de fluxo de trabalho.
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
- Reconhecimento abrangente de código de barrasSuporte para códigos de barras 1D e 2D, incluindo: QR codes, DataMatrix, PDF417, Code128, códigos postais e formatos industriais especializados
- Sem costura PDF IntegraçãoProcessamento direto de PDF documentos com suporte para todos PDF versões e estruturas de documentos complexas
- Processamento de Páginas FlexívelProcessar páginas específicas, intervalos de páginas ou documentos inteiros com recursos de extração seletiva de código de barras.
- Processamento em lote empresarialExtraia vários códigos de barras de uma ou várias páginas com fluxos de trabalho de processamento automatizados.
- Saída de dados estruturadosRetornar dados de código de barras em formato estruturado JSON Formato com coordenadas de posição, informações de tipo e metadados para fácil integração do sistema.
Tipos de código de barras suportados
O API Suporta uma ampla gama de formatos de código de barras para reconhecimento confiável:
Códigos de barras 1D
- Code128 - Formato universal de código de barras
- Code39 - Código de barras alfanumérico
- Code93 - Código de barras de alta densidade
- Codabar - Código de barras numérico
- EAN8/EAN13 - Número do artigo europeu
- UPC-A/UPC-E - Código Universal do Produto
- Inter2of5 - Industrial 2 de 5
- PatchCode - Códigos de processamento de documentos
Códigos de barras 2D
- QR Code - Códigos de Resposta Rápida
- DataMatrix - Código de barras 2D de alta densidade
- PDF417 - Arquivo de dados portátil
- MicroQRCode - Compact QR variante
Formatos especializados
- Códigos Postais: Postnet, Planet, RM4SCC, Australia Post
- Correio Inteligente: USPS Códigos de barras Intelligent Mail
- PharmaCodeCódigos de barras farmacêuticos
- RSS Codes: Simbologia de Espaço Reduzido
Endpoint da API REST
O PDF4me REST API usa padrão HTTP Métodos para interagir com recursos. Todas as operações de leitura de código de barras são realizadas por meio de um único ponto de extremidade:
- Método: POST
- Ponto final:
/api/v2/ReadBarcodes
Parâmetros da API REST
Lista completa de parâmetros para a leitura do 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 |
|---|---|---|---|
| docContent* | Base64 | PDF conteúdo do arquivo codificado em Base64 | JVBERi... |
| docName* | String | PDF nome do arquivo com extensão .pdf | document.pdf |
| barcodeType* | Array | Conjunto de tipos de código de barras a serem detectados. Use ["all"] para todos os tipos, ou tipos específicos como ["qrCode"], ["dataMatrix", "code128"] | ["all"] |
| páginas* | String | Opções de página: "todos", "1", "1,3,5", "2-5", "1,3,7-10", "2-" | all |
| IsAsync* | 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 |
Opções de tipo de código de barras
| Tipo | Descrição | Categoria |
|---|---|---|
all | Detectar todos os tipos de código de barras suportados | Universal |
unknown | Detectar tipos de código de barras desconhecidos | Universal |
qrCode | QR Code reconhecimento | 2D |
dataMatrix | DataMatrix reconhecimento | 2D |
pdf417 | PDF417 reconhecimento | 2D |
code128 | Code128 reconhecimento | 1D |
code39 | Code39 reconhecimento | 1D |
ean13 | EAN13 reconhecimento | 1D |
upca | UPC-A reconhecimento | 1D |
all_1D | Todos os tipos de código de barras 1D | 1D |
all_2D | Todos os tipos de código de barras 2D | 2D |
Saída
O PDF4me Ler código de barras de PDF REST API Retorna respostas diferentes dependendo do modo de processamento. API retorna estruturado JSON Dados com informações de código de barras.
- Success Response
- Asynchronous Processing
- Error Responses
- Response Format Details
Processamento síncrono (padrão)
Quando IsAsync 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:
{
"barcodes": [
{
"type": "qrCode",
"text": "Barcode content",
"page": 1,
"x": 100,
"y": 200,
"width": 50,
"height": 50
}
]
}
Campos de resposta:
- códigos de barras (array): Matriz de objetos de código de barras detectados
- tipo (string): Tipo de código de barras (por exemplo, "qrCode", "dataMatrix", "code128")
- texto (string): Conteúdo/texto do código de barras extraído
- página (número): Número da página onde o código de barras foi encontrado
- x (número): Coordenada X da posição do código de barras
- e (número): Coordenada Y da posição do código de barras
- largura (número): Largura do código de barras
- altura (número): Altura do código de barras
Exemplo (JavaScript):
const response = await fetch(url, options);
const data = await response.json();
data.barcodes.forEach(barcode => {
console.log(`Found ${barcode.type}: ${barcode.text} on page ${barcode.page}`);
});
Processamento assíncrono
Quando IsAsync: 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/ReadBarcodes/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 o mesmo JSON formato com dados de código de barras
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.barcodes array
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 (
conteúdo do documento,nomeDoDocumento,tipo de código de barras,páginas,É assíncrono) - Inválido Base64 codificação em
conteúdo do documento - Formato de matriz de tipo de código de barras inválido
- Especificação de página inválida
- 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
- PDF falha de processamento
- Falha no reconhecimento 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 sempre retorna JSON com dados de código de barras estruturados.
Estrutura da resposta:
{
"barcodes": [
{
"type": "string", // Barcode type
"text": "string", // Extracted barcode content
"page": number, // Page number (1-based)
"x": number, // X coordinate
"y": number, // Y coordinate
"width": number, // Barcode width
"height": number // Barcode height
}
]
}
Content-Type Cabeçalho:
- Sucesso:
application/json
Resultados vazios: Se nenhum código de barras for encontrado, a resposta conterá uma matriz vazia:
{
"barcodes": []
}
Vários códigos de barras:
O API Pode detectar vários códigos de barras na mesma página ou em páginas diferentes. Todos os códigos de barras detectados são incluídos no barcodes variedade.
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:
{
"docContent": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPD4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA2MTIgNzkyXQovUmVzb3VyY2VzIDw8Ci9Gb250IDw8Ci9GMSA0IDAgUgo+Pgo+PgovQ29udGVudHMgNSAwIFIKPj4KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL0ZvbnQKL1N1YnR5cGUgL1R5cGUxCi9CYXNlRm9udCAvSGVsdmV0aWNhCj4+CmVuZG9iago1IDAgb2JqCjw8Ci9MZW5ndGggNDQKPj4Kc3RyZWFtCkJUCi9GMSAxMiBUZgoxMDAgNzAwIFRkCihIZWxsbyBXb3JsZCkgVGoKRVQKZW5kc3RyZWFtCmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1NCAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAxNzAgMDAwMDAgbiAKMDAwMDAwMDI0NCAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9TaXplIDYKL1Jvb3QgMSAwIFIKPj4Kc3RhcnR4cmVmCjM0MQolJUVPRg==",
"docName": "document.pdf",
"barcodeType": ["all"],
"pages": "all",
"IsAsync": true
}
Exemplos de código
O PDF4me Ler código de barras de 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#
- Java
- JavaScript
- Python
- Salesforce
- n8n
- Google Script
- AWS Lambda
C# (CSharp) Amostra
Completo C# Implementação para leitura de códigos de barras de PDF documentos:
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
- Finance & Banking
- Business & Enterprise
- E-commerce & Retail
- Government & Compliance
- Technology & Development
Casos de uso em finanças e bancos
- Processamento de faturasExtrair dados de código de barras de faturas para processamento automatizado de pagamentos.
- Documentos financeirosProcessar documentos financeiros com códigos de barras para processamento de pagamentos.
- Processamento de PagamentosExtrair informações de pagamento de códigos de barras em documentos financeiros.
- Integração bancáriaIntegrar a leitura de códigos de barras em aplicativos e sistemas bancários.
Casos de uso para empresas e negócios
- Gestão de estoqueLeia os códigos de barras dos produtos a partir de PDF documentos para rastreamento de estoque
- Gestão da cadeia de abastecimentoRastrear produtos através da extração de dados de código de barras de PDF documentos
- Integração de dadosIntegrar dados de código de barras de PDFs em sistemas de negócios
- Automação de DocumentosAutomatizar a extração de dados de código de barras de documentos digitalizados.
- Automação de fluxo de trabalhoAutomatizar a extração de dados de código de barras em sistemas de gerenciamento de documentos
- Automação de Processos de NegócioAutomatize os fluxos de trabalho de processamento de códigos de barras para operações empresariais.
Casos de uso de comércio eletrônico e varejo
- Rastreamento de ProdutosLeia os códigos de barras dos produtos a partir de PDF documentos para gestão de estoque
- Processamento de PedidosExtrair dados de código de barras de documentos de pedidos para processamento.
- Controle de qualidadeVerificar informações do produto usando dados de código de barras de PDF relatórios
- Gestão da cadeia de abastecimentoRastrear produtos através da extração de dados de código de barras de PDF documentos
Casos de uso para governo e conformidade
- Monitoramento de ConformidadeExtrair códigos de rastreamento de documentos de conformidade.
- Documentação regulamentarProcessar documentos regulatórios com códigos de barras
- Documentos governamentaisExtrair dados de código de barras de documentos governamentais.
- Registros PúblicosProcessar registros públicos com informações de código de barras
Casos de uso de tecnologia e desenvolvimento
- API IntegraçãoIntegrar a leitura de códigos de barras aos fluxos de trabalho de processamento de documentos existentes.
- Processamento em loteProcessar grandes volumes de PDF documentos para extração de código de barras
- Validação de dadosValidar os dados do código de barras extraídos de PDF documentos
- Processamento de formuláriosExtrair informações do código de barras de PDF formulários e aplicativos
- Integração de SistemasIntegrar a leitura de códigos de barras em sistemas e fluxos de trabalho empresariais.
Recursos de reconhecimento de código de barras
Capacidades de detecção
- Suporte a múltiplos formatosReconhecimento de códigos de barras 1D e 2D em vários formatos.
- Rastreamento de posiçãoLocalização precisa do código de barras e dados de posicionamento com coordenadas.
- Seleção de páginaProcessar páginas específicas ou documentos inteiros usando opções de página
Recursos de processamento
- Reconhecimento de lotesExtrair vários códigos de barras de uma ou várias páginas.
- Filtragem por tipoEspecifique quais tipos de código de barras detectar usando o
barcodeTypevariedade - Saída EstruturadaRetorna dados de código de barras com informações de tipo, texto, página e posição.