API V2

Agregar código de barras al PDF

Transforma tus documentos PDF con nuestra potente API de código de barras que admite más de 150 tipos de códigos de barras, incluidos códigos QR, Code128, DataMatrix, Aztec, Hanxin y PDF417. Perfecta para sistemas de inventario, etiquetas de envío, seguimiento de documentos y flujos de trabajo automatizados.

Características clave:

  • 150+ tipos de códigos de barras: Código QR, Code128, DataMatrix, Aztec, Hanxin, PDF417 y más
  • Posicionamiento flexible: Coloca códigos de barras en cualquier parte de tu PDF con control preciso
  • Múltiples formatos: Soporte para milímetros y puntos para un tamaño exacto
  • Opciones de visualización de texto: Mostrar u ocultar el texto del código de barras, posicionar arriba o abajo
  • Control de opacidad: Ajusta la transparencia para efectos de marca de agua
  • Procesamiento por lotes: Agrega códigos de barras a varias páginas o documentos

Casos de uso populares:

  • E-commerce: Catálogos de productos con etiquetas de código de barras
  • Logística: Etiquetas de envío y documentos de seguimiento
  • Salud: Registros de pacientes y administración de medicamentos
  • Gobierno: Documentos de identidad y formularios de cumplimiento
  • Educación: Carnés de estudiante y sistemas de biblioteca

Esta API generadora de códigos de barras se integra perfectamente con tus flujos de trabajo existentes, brindando fiabilidad y rendimiento de nivel empresarial.

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

Autenticar tu solicitud API

Para acceder a la API Web de PDF4me, cada solicitud debe incluir credenciales de autenticación adecuadas. La autenticación garantiza una comunicación segura y valida tu identidad como usuario autorizado.


Tipos de códigos de barras compatibles

Nuestra API de generador de códigos de barras admite 150+ tipos de códigos de barras, convirtiéndola en la solución más completa para la integración de códigos de barras PDF.

Códigos de barras 1D (Lineales)

  • Code128: Código de barras 1D más versátil, admite todos los caracteres ASCII
  • Code39: Código de barras alfanumérico, ampliamente utilizado en logística
  • EAN13/EAN8: Identificación internacional de productos minoristas
  • UPC-A/UPC-E: Estándar minorista norteamericano
  • Code93: Versión mejorada de Code39 con mejor densidad

Códigos de barras 2D (Matriz)

  • Código QR: Código de barras 2D más popular para escaneo móvil
  • DataMatrix: Código de barras 2D de alta densidad, perfecto para artículos pequeños
  • PDF417: Código de barras lineal apilado con gran capacidad de datos
  • Aztec: Código de barras 2D con excelente corrección de errores
  • Hanxin: Estándar nacional chino de código de barras 2D

PDF4me api samples

CSharp(C#)
Java
JavaScript
Python
Salesforce
Google Script
AWS Lambda

Parámetros de API

Lista completa de parámetros para la API Add Barcode to PDF. Los parámetros están organizados por categoría para mejor comprensión e implementación.

Contenido del documentoBase64, Required

El contenido del documento PDF codificado en formato Base64. Este es el archivo PDF fuente al que se le agregarán códigos de barras. El archivo debe ser un documento PDF válido.

Ejemplo:JVBERi0xLjQKJcOkw7zDtsO8CjIgMCBvYmoKPDwKL0xlbmd0aCAzIDAgUgo+PgpzdHJlYW0K...

Nombre del documentostring, Required

El nombre del archivo PDF de origen. Debe incluir la extensión .pdf. Este nombre se utilizará para referencia y puede aparecer en los mensajes de error.

Ejemplos:

  • document.pdf
  • invoice-2024.pdf
  • report-final.pdf
Datos del código de barrasstring, Required

Los datos que se codificarán en el código de barras. Puede ser texto, números, URLs o cualquier cadena que el tipo de código de barras seleccionado soporte. Los datos se convertirán en una imagen de código de barras escaneable.

Ejemplos:

  • Texto:Hello World
  • URL:https://example.com
  • Código de producto:ABC123456
  • Teléfono:+1-555-123-4567

Nota: Diferentes tipos de códigos de barras tienen diferentes límites de capacidad de datos y restricciones de caracteres.

Tipo de código de barrasstring, Required

Especifique el tipo de código de barras a generar. Elija entre más de 150 formatos de códigos de barras compatibles, incluyendo códigos QR, códigos de barras lineales y códigos matriciales 2D.

Tipos populares:

  • Código QR:qrCode - Código de barras 2D más versátil
  • Code128:code128 - Código de barras 1D universal
  • DataMatrix:dataMatrix - Código de barras 2D de alta densidad
  • EAN13:ean13 - Código de producto internacional
  • UPC-A:upcA - Estándar minorista norteamericano

Consulte la lista completa de tipos de códigos de barras compatibles anteriormente para todas las opciones disponibles.

Páginas objetivostring, Required

Especifique qué páginas deben tener códigos de barras agregados. Use selección flexible de páginas con valores separados por comas y rangos.

Ejemplos de formato:

  • Todas las páginas:"" (cadena vacía)
  • Página única:"0" (primera página)
  • Páginas múltiples:"0, 2, 4"
  • Rango de páginas:"1-5" (páginas 2-6)
  • Mixto:"0, 2-4, 7" (página 1, páginas 3-5, página 8)
  • Desde página hasta el final:"3-" (página 4 hasta el final)

Nota: Los índices de página están basados en 0 (primera página = 0). Si no se especifica, se agregan códigos de barras a todas las páginas.

Alineación horizontalstring, Required

Controla el posicionamiento horizontal del código de barras en la página. Esto determina dónde aparece el código de barras horizontalmente en relación con los márgenes de la página.

Opciones:

  • Left - Alinear al borde izquierdo de la página
  • Center - Centrar horizontalmente en la página
  • Right - Alinear al borde derecho de la página

Ejemplo:"Center" colocará el código de barras en el medio de la página horizontalmente.

Alineación verticalstring, Required

Controla el posicionamiento vertical del código de barras en la página. Esto determina dónde aparece el código de barras verticalmente en relación con los márgenes de la página.

Opciones:

  • Top - Alinear al borde superior de la página
  • Middle - Centrar verticalmente en la página
  • Bottom - Alinear al borde inferior de la página

Ejemplo:"Bottom" colocará el código de barras en la parte inferior de la página verticalmente.

Altura del código de barras (mm)string, Required

Establezca la altura del código de barras en milímetros. Esto controla el tamaño vertical del código de barras generado.

Alturas recomendadas:

  • Códigos QR: 20-60mm (40mm recomendado)
  • Códigos de barras 1D: 15-30mm (20mm recomendado)
  • DataMatrix: 10-40mm (20mm recomendado)

Redimensionamiento automático: Ingrese "0" para que el sistema determine automáticamente la altura óptima basada en el tipo de código de barras y los datos.

Ejemplo:"40" crea un código de barras de 40mm de altura.

Ancho en mmstring, Required

Ancho del código de barras en milímetros. ‘0’ para detección automática.
Ejemplo - 40.

Margen horizontal en mmstring, Required

Margen desde el origen izquierdo del código de barras en milímetros
Ejemplo - 20

Margen vertical en mmstring, Required

Margen desde el origen superior del código de barras en milímetros
Ejemplo - 20

Altura en PtString, Required

Altura del código de barras en puntos (pt). o ‘0’ para detección automática.
Ejemplo - 20.

Ancho en PtString, Required

Ancho del código de barras en puntos (pt). o ‘0’ para detección automática.
Ejemplo - 20.

Margen X en PtString, Required

Margen desde el origen superior del código de barras en puntos (pt).
Ejemplo - 10.

Margen Y en PtString, Required

Margen desde el origen izquierdo del código de barras en puntos (pt).
Ejemplo - 10.

Opacidadinteger, Required

Dé una valor entre 0 y 100 donde ‘0’ es completamente transparente.
Ejemplo - 100.

Mostrar textoString, Required

El texto se mostrará -
arriba
abajo

Ocultar textoBoolean, Required

Seleccione ‘true’ para ocultar el texto del código de barras y ‘false’ para mostrarlo junto al código de barras.

  • true
  • false
Mostrar solo en impresiónBoolean, Required

Si desea Mostrar solo en impresión, mostrar solo en impresión. Puede elegir estas dos opciones.
true
false

¿El texto está arribaBoolean, Required

Si desea ¿El texto está arriba, puede elegir estas dos opciones.
true
false


Salida

La API devuelve el documento PDF procesado con códigos de barras incrustados. La respuesta incluye el contenido del archivo y metadatos para una fácil integración en su flujo de trabajo de aplicación.

Contenido del archivoBinary

Contenido binario del documento PDF procesado con códigos de barras incrustados. Listo para descarga o procesamiento adicional.

Nombre del archivoString

Nombre de archivo para el documento PDF procesado. Se puede personalizar o generar automáticamente según sus requisitos.

Encabezado
Content-Type: application/json
Authorization: Por favor, copie la clave desde el enlace.

Payload

{
  "alignX": "Right",
  "alignY": "Top",
  "docContent": "Please put PDF base64 content",
  "docName": "output.pdf",
  "text": "hello",
  "barcodeType": "qrCode",
  "pages": "2",
  "heightInMM": "40",
  "widthInMM": "40",
  "marginXInMM": "20",
  "marginYInMM": "20",
  "heightInPt": "20",
  "widthInPt": "20",
  "marginXInPt": "10",
  "marginYInPt": "10",
  "opacity": 100,
  "displayText": "above",
  "hideText": true,
  "showOnlyInPrint": false,
  "isTextAbove": true
}

Casos de uso industriales y aplicaciones

E-commerce y retail

  • Catálogos de productos: Generar códigos de barras para gestión de inventario e identificación de productos
  • Etiquetas de precio: Crear precios dinámicos con integración de códigos de barras para checkout automatizado
  • Seguimiento de pedidos: Añadir códigos de seguimiento a documentos de envío para monitoreo en tiempo real
  • Sistemas de inventario: Generación masiva de códigos de barras para gestión de almacén

Logística y envíos

  • Etiquetas de envío: Añadir códigos de barras de seguimiento a documentos de entrega
  • Seguimiento de paquetes: Generar identificadores únicos para cada envío en la cadena de suministro
  • Gestión de almacén: Crear códigos de barras para ubicaciones y identificación de productos
  • Cadena de suministro: Rastrear productos a través de toda la red de distribución

Salud y médica

  • Registros de pacientes: Añadir códigos de barras para identificación rápida de pacientes
  • Administración de medicamentos: Generar códigos de barras para seguimiento de medicamentos
  • Equipamiento médico: Etiquetar equipos con códigos de barras de mantenimiento
  • Resultados de laboratorio: Añadir códigos de barras a documentos de resultados

🏛️ Gobierno y cumplimiento

  • Documentos de identidad: Añadir códigos de barras de seguridad a licencias y pasaportes
  • Documentos fiscales: Generar códigos de seguimiento para formularios fiscales
  • Formularios de cumplimiento: Añadir códigos de barras para seguimiento regulatorio
  • Registros públicos: Crear identificadores de documentos consultables

🎓 Educación y bibliotecas

  • Carnés estudiantiles: Generar códigos de barras para identificación de estudiantes
  • Sistemas de biblioteca: Añadir códigos de barras a libros y recursos
  • Documentos de examen: Crear identificadores únicos para pruebas
  • Servicios de campus: Rastrear uso de equipos y recursos

💼 Empresa y finanzas

  • Procesamiento de facturas: Añadir códigos de barras para manejo automatizado de facturas
  • Gestión de documentos: Crear identificadores únicos para documentos empresariales
  • Seguimiento de activos: Generar códigos de barras para equipos y activos
  • Huellas de auditoría: Añadir códigos de seguimiento para documentación de cumplimiento