Saltar al contenido principal
PDF4me APIIntegracionesBase de conocimientosExtensionesProbador de APIBlog

Agregar código de barras a PDF - QR Code Integración API

PDF4me Agregar código de barras a PDF le permite agregar códigos de barras profesionales y QR codes a PDF documentos con controles precisos de posicionamiento, tamaño y formato. API procesos de servicio PDF archivos y agrega códigos de barras usando Base64 codificación para transmisión segura. Con soporte para más de 150 tipos de códigos de barras, incluyendo QR codes, Code128, DataMatrix, Aztec, Hanxin, PDF417Gracias a sus formatos especializados, esta solución es ideal para sistemas de gestión de inventario, automatización de etiquetas de envío, flujos de trabajo de seguimiento de documentos e integración de códigos de barras empresariales.

Entradas de blog relacionadas(1)

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.

Get your api Key

Características principales​

  • Soporte integral para códigos de barras: Más de 150 tipos de códigos de barras, incluyendo QR codes, Code128, DataMatrix, Aztec, Hanxin, PDF417códigos postales y formatos especializados de la industria
  • Control de posicionamiento preciso: Coloque los códigos de barras en cualquier lugar de PDF Páginas con precisión de píxel perfecta utilizando sistemas de medición tanto en milímetros como en puntos.
  • Opciones de tamaño avanzadasDimensiones de código de barras flexibles con capacidad de ajuste automático y controles de ancho/alto personalizados para un rendimiento de escaneo óptimo.
  • Gestión profesional de textosConfigure la visualización, el posicionamiento (arriba/abajo) y la visibilidad del texto del código de barras con opciones de formato personalizables.
  • Opacidad y transparencia: Ajuste los niveles de transparencia del código de barras para efectos de marca de agua, superposiciones de documentos y presentación profesional.
  • Procesamiento por lotes empresarialAgregue códigos de barras a varias páginas, documentos o colecciones completas de documentos con flujos de trabajo de procesamiento automatizados.

REST API Punto final​

El PDF4me REST API utiliza estándar HTTP métodos para interactuar con los recursos. Todas las operaciones con códigos de barras se realizan a través de un único punto final:

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

Tipos de códigos de barras compatibles​

Admite más de 150 tipos de códigos de barras para una gestión integral. PDF integración.

Códigos de barras 1D populares​

  • Code128 - Código de barras universal (máximo 255 caracteres)
  • Code39 - Código de barras alfanumérico (máximo 43 caracteres)
  • EAN13/EAN8 - Códigos de producto para venta al por menor (13/8 caracteres)
  • UPC-A/UPC-E - Venta minorista en Norteamérica (12/8 caracteres)

Códigos de barras 2D populares​

  • QR Code - Escaneo móvil (máximo 4296 caracteres)
  • DataMatrix - Alta densidad 2D (máximo 2335 caracteres)
  • PDF417 - Gran capacidad de almacenamiento (máximo 2710 caracteres)
  • Aztec - Excelente corrección de errores (máximo 3832 caracteres)

Formatos especializados​

  • Códigos postales: USPS, Royal Mail, Australia Post, Deutsche Post
  • Cuidado de la salud: HIBC, GS1 DataBar, Pharmacode
  • Logística: MaxiCode, SSCC-18, ITF-14, GS1-128
  • Variantes de códigos QR: Micro QR, iQR, rMQR

REST API Parámetros​

Lista completa de parámetros para Agregar código de barras a 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ámetroTipoDescripciónEjemplo
docName*StringProducción PDF Nombre del archivo con extensión .pdfoutput.pdf
docContent*Base64El contenido de la entrada PDF archivo codificado en Base64JVBERi...
texto*StringTexto que se codificará en el código de barras. La longitud del texto depende del tipo de código de barras.PDF4me Barcode Sample
barcodeType*StringTipo de formato de código de barras. Opciones: qrCode, code128, dataMatrix, aztec, hanxin, pdf417, code39, ean13, ean8, upcA, upcEqrCode
páginas*StringPáginas de destino (p. ej., "1-3", "todas", "1", "1,3,5", "2-5", "1,3,7-10", "2-")1-3
alignX*StringAlineación horizontal: Izquierda, Centro, o BienRight
alignY*StringAlineación vertical: Arriba, Medio, o AbajoBottom
hideText*BooleanOcultar la etiqueta de texto del código de barras (verdadero=ocultar, falso=mostrar el texto junto al código de barras)true

Parámetros opcionales​

ParámetroTipoDescripciónEjemplo
heightInMMStringAltura del código de barras en milímetros (0 = automático)40
widthInMMStringAncho del código de barras en milímetros (0 = automático)40
marginXInMMStringMargen horizontal en milímetros20
marginYInMMStringMargen vertical en milímetros20
heightInPtStringAltura del código de barras en puntos113
widthInPtStringAncho del código de barras en puntos113
marginXInPtStringMargen horizontal en puntos57
marginYInPtStringMargen vertical en puntos57
opacityIntegerNivel de transparencia (0-100): 0=invisible, 100=totalmente opaco100
displayTextStringPosición del texto: arriba o abajobelow
showOnlyInPrintBooleanMostrar solo en la versión impresa (verdadero) o en la versión impresa y en la versión digital (falso)false
isTextAboveBooleanTexto encima del código de barras (verdadero) o debajo (falso)false
asyncBooleanHabilitar el procesamiento asíncrono. Cuando true, el API devuelve un estado 202 y proporciona una encuesta URL en el Location encabezadotrue

Producción​

El PDF4me Agregar código de barras a PDF REST API devuelve diferentes respuestas según el modo de procesamiento. API devuelve el PDF como un Base64cadena codificada en JSON formato, no como datos binarios.

Procesamiento síncrono (predeterminado)

Cuando async 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:

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

Campos de respuesta:

  • docName (cadena): La salida PDF Nombre del archivo
  • docContent (cadena): El PDF archivo con código de barras añadido, codificado como Base64 cadena

Cómo usarlo:

  1. Extraer el docContent campo del JSON respuesta
  2. Decodifica el Base64 cadena para obtener el binario PDF datos
  3. Guardar o procesar el PDF Archivo según sea necesario

Ejemplo (JavaScript):

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

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 usar Authorization: Basic YWJjMTIz

Carga útil​

Ejemplo básico (solo campos obligatorios):

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

Ejemplo avanzado (con todos los campos opcionales):

{
  "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
}

Ejemplos de código​

El PDF4me Agregar código de barras a 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# (CSharp) Muestra

Completo C# implementación para agregar códigos de barras a PDF documentos:

Casos de uso y aplicaciones en la industria​

Casos de uso en comercio electrónico y venta minorista

  • Catálogos de productosGenerar códigos de barras para la gestión de inventario y la identificación de productos.
  • Etiquetas de precio: Crea precios dinámicos con integración de códigos de barras para un proceso de pago automatizado.
  • Seguimiento de pedidos: Agregue códigos de seguimiento a los documentos de envío para el monitoreo de paquetes en tiempo real.
  • Sistemas de inventarioGeneración masiva de códigos de barras para la gestión de almacenes y el control de existencias.

Obtén ayuda​

Get Your API KeyAPI SamplesGetting Started