Leer código de barras desde PDF - Escáner y extractor API
PDF4me Leer código de barras desde PDF le permite extraer y reconocer varios tipos de códigos de barras y QR codes de PDF documentos que utilizan tecnología avanzada OCR y tecnología de reconocimiento de códigos de barras. API procesos de servicio PDF Archivos y extrae datos de códigos de barras con coordenadas de posición, información de tipo y texto extraído. API recibe PDF contenido a través de REST API llamadas, utilizando Base64 codificación para transmisión segura. Con soporte para códigos de barras 1D y 2D, incluyendo QR codes, DataMatrix, PDF417, Code128Gracias a su compatibilidad con formatos especializados del sector y otros formatos industriales, esta solución es ideal para el procesamiento de documentos, la gestión de inventarios, los sistemas de seguimiento y la automatización de flujos de trabajo.
Autenticando su API Pedido
Para acceder al PDF4me REST APICada solicitud debe incluir las credenciales de autenticación adecuadas. La autenticación garantiza una comunicación segura y valida su identidad como usuario autorizado del sistema. REST API.
Características principales
- Reconocimiento integral de códigos de barras: Compatibilidad con códigos de barras 1D y 2D, incluyendo QR codes, DataMatrix, PDF417, Code128códigos postales y formatos especializados de la industria
- Sin fisuras PDF Integración: Procesamiento directo de PDF documentos con apoyo para todos PDF versiones y estructuras de documentos complejas
- Procesamiento de páginas flexible: Procesar páginas específicas, rangos de páginas o documentos completos con capacidades de extracción selectiva de códigos de barras.
- Procesamiento por lotes empresarial: Extrae múltiples códigos de barras de una o varias páginas mediante flujos de trabajo de procesamiento automatizados.
- Salida de datos estructurados: Devuelve los datos del código de barras en formato estructurado JSON Formato con coordenadas de posición, información de tipo y metadatos para una fácil integración del sistema.
Tipos de códigos de barras compatibles
El API Admite una amplia gama de formatos de código de barras para un reconocimiento fiable:
Códigos de barras 1D
- Code128 - Formato de código de barras universal
- Code39 - Código de barras alfanumérico
- Code93 - Código de barras de alta densidad
- Codabar - Código de barras numérico
- EAN8/EAN13 - Número de artículo europeo
- UPC-A/UPC-E - Código Universal de Producto
- Inter2of5 - Industrial 2 de 5
- PatchCode - Códigos de procesamiento de documentos
Códigos de barras 2D
- QR Code - Códigos de respuesta rápida
- DataMatrix - Código de barras 2D de alta densidad
- PDF417 - Archivo de datos portátil
- MicroQRCode - Compact QR variante
Formatos especializados
- Códigos postales: Postnet, Planet, RM4SCC, Australia Post
- Correo inteligente: USPS Códigos de barras de correo inteligente
- PharmaCode: Códigos de barras farmacéuticos
- RSS CodesSimbología de espacio reducido
Punto final de la API REST
El PDF4me REST API utiliza estándar HTTP métodos para interactuar con los recursos. Todas las operaciones de lectura de códigos de barras se realizan a través de un único punto final:
- Método: POST
- Punto final:
/api/v2/ReadBarcodes
Parámetros de la API REST
Lista completa de parámetros para la lectura del código de barras desde PDF REST APILos parámetros están organizados por categoría para una mejor comprensión e implementación.
Importante: Los parámetros marcados con un asterisco (*) son obligatorios y deben proporcionarse para la API para que funcione correctamente.
Parámetros requeridos
| Parámetro | Tipo | Descripción | Ejemplo |
|---|---|---|---|
| docContent* | Base64 | PDF contenido del archivo codificado en Base64 | JVBERi... |
| docName* | String | PDF Nombre del archivo con extensión .pdf | document.pdf |
| barcodeType* | Array | Matriz de tipos de códigos de barras para detectar. Utilizar ["all"] para todos los tipos, o tipos específicos como ["qrCode"], ["dataMatrix", "code128"] | ["all"] |
| páginas* | String | Opciones de página: "todas", "1", "1,3,5", "2-5", "1,3,7-10", "2-" | all |
| IsAsync* | Boolean | Habilitar el procesamiento asíncrono. Cuando true, el API devuelve un estado 202 y proporciona una encuesta URL en el Location encabezado | true |
Opciones de tipo de código de barras
| Tipo | Descripción | Categoría |
|---|---|---|
all | Detectar todos los tipos de códigos de barras compatibles | Universal |
unknown | Detectar tipos de códigos de barras desconocidos | Universal |
qrCode | QR Code reconocimiento | 2D |
dataMatrix | DataMatrix reconocimiento | 2D |
pdf417 | PDF417 reconocimiento | 2D |
code128 | Code128 reconocimiento | 1D |
code39 | Code39 reconocimiento | 1D |
ean13 | EAN13 reconocimiento | 1D |
upca | UPC-A reconocimiento | 1D |
all_1D | Todos los tipos de códigos de barras 1D | 1D |
all_2D | Todos los tipos de códigos de barras 2D | 2D |
Producción
El PDF4me Leer código de barras desde PDF REST API devuelve diferentes respuestas según el modo de procesamiento. API devoluciones estructuradas JSON datos con información de código de barras.
- Success Response
- Asynchronous Processing
- Error Responses
- Response Format Details
Procesamiento síncrono (predeterminado)
Cuando IsAsync no está configurado o está configurado false, el API procesa la solicitud inmediatamente:
Código de estado: 200 OK
Content-Type: application/json
Cuerpo de la respuesta:
{
"barcodes": [
{
"type": "qrCode",
"text": "Barcode content",
"page": 1,
"x": 100,
"y": 200,
"width": 50,
"height": 50
}
]
}
Campos de respuesta:
- códigos de barras (matriz): Matriz de objetos de código de barras detectados
- tipo (cadena): Tipo de código de barras (por ejemplo, "qrCode", "dataMatrix", "code128")
- texto (cadena): Contenido/texto del código de barras extraído
- página (número): Número de página donde se encontró el código de barras
- incógnita (número): Coordenada X de la posición del código de barras
- y (número): Coordenada Y de la posición del código de barras
- ancho (número): Ancho del código de barras
- altura (número): Altura del código de barras
Ejemplo (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}`);
});
Procesamiento asíncrono
Cuando IsAsync: true está establecido, el API procesa la solicitud de forma asíncrona:
Código de estado: 202 Accepted
Encabezados de respuesta:
Location: https://api.pdf4me.com/api/v2/ReadBarcodes/poll/12345-abcde-67890
Proceso de votación:
- Extraer el
Locationencabezado de la respuesta 202 - Encuesta la URL usando GET solicitudes
- Continúe realizando encuestas hasta que reciba una 200 OK estado
- La respuesta final contiene lo mismo JSON formato con datos de código de barras
Ejemplo de encuesta:
// 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
}
Respuestas de error
El API devuelve estándar HTTP Códigos de error con detalles del error:
- Parámetros de solicitud no válidos
- Faltan campos obligatorios (
docContent,Nombre del documento,tipo de código de barras,páginas,EsAsync) - Inválido Base64 codificación en
docContent - Formato de matriz de tipo de código de barras no válido
- Especificación de página no válida
- Inválido o faltante API llave
- API La llave no funciona correctamente. Base64 codificado en Authorization encabezado
- Desaparecido
Authorization: Básicoencabezado
- Error de procesamiento del servidor
- PDF fallo de procesamiento
- Fallo en el reconocimiento del código de barras
Formato de respuesta de error:
{
"error": "Error message describing what went wrong"
}
Detalles del formato de respuesta
Importante: El API siempre regresa JSON con datos de código de barras estructurados.
Estructura de respuesta:
{
"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 Encabezado:
- Éxito:
application/json
Resultados vacíos: Si no se encuentran códigos de barras, la respuesta contendrá una matriz vacía:
{
"barcodes": []
}
Múltiples códigos de barras:
El API Puede detectar varios códigos de barras en la misma página o en diferentes páginas. Todos los códigos de barras detectados se incluyen en el barcodes matriz.
Ejemplo de solicitud
Encabezamiento
Content-Type: application/json
Authorization: Basic YOUR_BASE64_ENCODED_API_KEY
Nota:
- Consigue tu API clave del PDF4me Panel
- El API La clave debe ser Base64 codificado y prefijado con "Basic" en el Authorization encabezado
- Ejemplo: Si su API La clave es
abc123, codificarlo a Base64 y usarAuthorization: Basic YWJjMTIz
Carga útil
Ejemplo:
{
"docContent": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPD4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA2MTIgNzkyXQovUmVzb3VyY2VzIDw8Ci9Gb250IDw8Ci9GMSA0IDAgUgo+Pgo+PgovQ29udGVudHMgNSAwIFIKPj4KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL0ZvbnQKL1N1YnR5cGUgL1R5cGUxCi9CYXNlRm9udCAvSGVsdmV0aWNhCj4+CmVuZG9iago1IDAgb2JqCjw8Ci9MZW5ndGggNDQKPj4Kc3RyZWFtCkJUCi9GMSAxMiBUZgoxMDAgNzAwIFRkCihIZWxsbyBXb3JsZCkgVGoKRVQKZW5kc3RyZWFtCmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1NCAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAxNzAgMDAwMDAgbiAKMDAwMDAwMDI0NCAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9TaXplIDYKL1Jvb3QgMSAwIFIKPj4Kc3RhcnR4cmVmCjM0MQolJUVPRg==",
"docName": "document.pdf",
"barcodeType": ["all"],
"pages": "all",
"IsAsync": true
}
Ejemplos de código
El PDF4me Leer código de barras desde PDF REST API Proporciona ejemplos de código en varios lenguajes de programación. Elija el lenguaje que mejor se adapte a su entorno de desarrollo:
- C#
- Java
- JavaScript
- Python
- Salesforce
- n8n
- Google Script
- AWS Lambda
C# (CSharp) Muestra
Completo C# implementación para leer códigos de barras desde PDF documentos:
Java Muestra
Java Implementación con manejo completo de errores y procesamiento de respuestas:
JavaScript Muestra
Node.js y compatible con navegadores JavaScript implementación:
Google Script Muestra
Google Apps Script implementación para Google Workspace integración:
Casos de uso y aplicaciones en la industria
- Finance & Banking
- Business & Enterprise
- E-commerce & Retail
- Government & Compliance
- Technology & Development
Casos de uso en finanzas y banca
- Procesamiento de facturas: Extraer datos de códigos de barras de las facturas para el procesamiento automatizado de pagos.
- Documentos financieros: Procesar documentos financieros con códigos de barras para el procesamiento de pagos.
- Procesamiento de pagos: Extraer información de pago de códigos de barras en documentos financieros
- Integración bancariaIntegrar la lectura de códigos de barras en las aplicaciones y sistemas bancarios.
Casos de uso para empresas y negocios
- Gestión de inventario: Leer códigos de barras de productos desde PDF documentos para el seguimiento de existencias
- Gestión de la cadena de suministro: Rastrear productos mediante la extracción de datos de códigos de barras PDF documentos
- Integración de datos: Integrar datos de código de barras de PDFs en sistemas empresariales
- Automatización de documentos: Automatizar la extracción de datos de códigos de barras de documentos escaneados
- Automatización del flujo de trabajoAutomatizar la extracción de datos de códigos de barras en sistemas de gestión documental.
- Automatización de procesos empresariales: Automatizar los flujos de trabajo de procesamiento de códigos de barras para las operaciones empresariales.
Casos de uso en comercio electrónico y venta minorista
- Seguimiento de productos: Leer códigos de barras de productos desde PDF documentos para la gestión de inventario
- Procesamiento de pedidos: Extraer datos de códigos de barras de los documentos de pedido para su procesamiento.
- Control de calidad: Verificar la información del producto utilizando los datos del código de barras de PDF informes
- Gestión de la cadena de suministro: Rastrear productos mediante la extracción de datos de códigos de barras PDF documentos
Casos de uso en materia de gobierno y cumplimiento normativo
- Monitoreo del cumplimientoExtraer códigos de seguimiento de documentos de cumplimiento
- Documentación reglamentaria: Procesar documentos reglamentarios con códigos de barras
- Documentos gubernamentales: Extraer datos de códigos de barras de documentos gubernamentales
- Registros públicos: Procesar registros públicos con información de código de barras
Casos de uso de tecnología y desarrollo
- API IntegraciónIntegrar la lectura de códigos de barras en los flujos de trabajo de procesamiento de documentos existentes.
- Procesamiento por lotes: Procesar grandes volúmenes de PDF documentos para extracción de códigos de barras
- Validación de datos: Validar los datos del código de barras extraídos de PDF documentos
- Procesamiento de formularios: Extraer información de código de barras de PDF formularios y solicitudes
- Integración de sistemasIntegrar la lectura de códigos de barras en los sistemas y flujos de trabajo empresariales.
Características de reconocimiento de códigos de barras
Capacidades de detección
- Compatibilidad con múltiples formatos: Reconocimiento de códigos de barras 1D y 2D en varios formatos
- Seguimiento de posición: Datos precisos de ubicación y posicionamiento del código de barras con coordenadas
- Selección de página: Procesar páginas específicas o documentos completos utilizando las opciones de página.
Características de procesamiento
- Reconocimiento de lotes: Extraer varios códigos de barras de una o varias páginas.
- Filtrado por tipo: Especifique qué tipos de códigos de barras se deben detectar utilizando el
barcodeTypematriz - Salida estructurada: Devuelve datos de código de barras con información sobre tipo, texto, página y posición.