Crear código de barras - QR Code Generador API
PDF4me Crear código de barras le permite crear códigos de barras independientes y QR code imágenes con soporte para más de 150 tipos de códigos de barras, incluyendo QR codes, Code128, DataMatrix, Aztec, Hanxin, PDF417y formatos especializados. Este API El servicio genera imágenes de códigos de barras compatibles, optimizadas para impresión, escaneo móvil y aplicaciones digitales. API recibe datos de texto y parámetros de código de barras a través de REST API llamadas, utilizando Base64 Codificación para una transmisión segura. Esta solución es ideal para sistemas de gestión de inventario, automatización del etiquetado de productos y flujos de trabajo de generación de códigos de barras empresariales.
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
- Biblioteca completa de 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 simbologías industriales especializadas mediante el parámetro Tipo de código de barras
- Generación de imágenes independiente: Crea imágenes de códigos de barras de alta calidad de forma independiente sin necesidad de documentos o plantillas existentes mediante la especificación del nombre del archivo.
- Gestión avanzada de textoConfigure la visualización, el posicionamiento y la visibilidad del texto del código de barras con opciones de formato profesionales para una presentación impecable mediante el parámetro Texto.
- Integración empresarial: Simple API con parámetros mínimos diseñados para una integración perfecta en los sistemas y flujos de trabajo empresariales existentes con una correcta asignación de parámetros.
REST API Punto final
El PDF4me REST API utiliza estándar HTTP métodos para interactuar con los recursos. Todas las operaciones de generación de códigos de barras se realizan a través de un único punto final:
- Método: POST
- Punto final:
/api/v2/CreateBarcode
Tipos de códigos de barras compatibles
Admite más de 150 tipos de códigos de barras para una generación integral de códigos de barras basada en el JSON especificación.
Códigos de barras 1D populares
- Code128 - Código de barras universal (máximo 255 caracteres) mediante el parámetro Tipo de código de barras.
- Code39 - Código de barras alfanumérico (máximo 43 caracteres) mediante parámetro de texto.
- EAN13/EAN8 - Códigos de productos minoristas (13/8 caracteres) con especificación de nombre de archivo
- UPC-A/UPC-E - Venta minorista norteamericana (12/8 caracteres) usando API integración
Códigos de barras 2D populares
- QR Code - Escaneo móvil (máximo 4296 caracteres) mediante el parámetro Tipo de código de barras.
- DataMatrix - Alta densidad 2D (máximo 2335 caracteres) mediante parámetro de texto
- PDF417 - Gran capacidad de datos (2710 caracteres como máximo) con especificación de nombre de archivo.
- Aztec - Excelente corrección de errores (máximo 3832 caracteres) usando API integración
Formatos especializados
- Códigos postales: USPS, Royal Mail, Australia Post, Deutsche Post utilizando el parámetro Tipo de código de barras
- Cuidado de la salud: HIBC, GS1 DataBar, Pharmacode a través del parámetro Texto
- Logística: MaxiCode, SSCC-18, ITF-14, GS1-128 con especificación de nombre de archivo
- Variantes de códigos QR: Micro QR, iQR, rMQR usando API integración
REST API Parámetros
Lista completa de parámetros para la creación de códigos de barras. 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 |
|---|---|---|---|
| texto* | String | Texto que se codificará en el código de barras. La longitud del texto depende del tipo de código de barras. | PDF4me Create Barcode Sample |
| barcodeType* | String | Tipo de formato de código de barras. Opciones: qrCode, code128, dataMatrix, aztec, hanXin, pdf417, code39, ean13, ean8, upcA, upcE | qrCode |
| hideText* | Boolean | Ocultar la etiqueta de texto del código de barras (verdadero=ocultar, falso=mostrar el texto junto al código de barras) | false |
| async* | Boolean | Habilitar el procesamiento asíncrono. Cuando true, el API devuelve un estado 202 y proporciona una encuesta URL en el Location encabezado | true |
Producción
El PDF4me Crear código de barras REST API devuelve diferentes respuestas según el modo de procesamiento. API devuelve el código de barras como un archivo de imagen binario (PNG formato), no como JSON.
- Success Response
- Asynchronous Processing
- Error Responses
- Response Format Details
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: image/png (o formato de imagen apropiado)
Cuerpo de la respuesta: El cuerpo de la respuesta contiene la imagen del código de barras como datos binarios (PNG formato por defecto).
Cómo usarlo:
- Lee el cuerpo de la respuesta como datos binarios.
- Guarda los datos binarios como un archivo de imagen (por ejemplo, .png, .jpg).
- Utilice el archivo de imagen según sea necesario.
Ejemplo (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
Ejemplo (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)
Procesamiento asíncrono
Cuando async: 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/CreateBarcode/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 la imagen del código de barras como datos binarios (PNG formato)
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 blob = await pollResponse.blob();
// Process blob (barcode image)
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 (
texto,tipo de código de barras,ocultarTexto,asíncrono) - Tipo de código de barras no válido
- La longitud del texto excede la capacidad del tipo de código de barras.
- 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
- Fallo en la generación 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 devuelve datos de imagen binarios (PNG formato por defecto), no JSON.
Estructura de respuesta:
- Content-Type:
image/png(o el tipo MIME de imagen apropiado) - Cuerpo de respuesta: Datos de imagen binarios
Formato de imagen:
- Formato predeterminado: PNG
- La imagen del código de barras está lista para su uso directo, descarga o integración.
Guardando la imagen:
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);
}
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:
{
"text": "PDF4me Create Barcode Sample",
"barcodeType": "qrCode",
"hideText": false,
"async": true
}
Ejemplos de código
El PDF4me Crear código de barras 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
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
- E-commerce & Retail
- Logistics & Shipping
- Healthcare & Medical
- Government & Compliance
- Education & Libraries
- Business & Finance
Casos de uso en comercio electrónico y venta minorista
- Etiquetas de productosGenerar imágenes de códigos de barras independientes para el embalaje y las etiquetas del producto utilizando el parámetro Tipo de código de barras.
- Etiquetas de precio: Crea imágenes de códigos de barras para precios dinámicos y sistemas de pago automatizados mediante el parámetro Texto.
- Gestión de inventarioGenerar imágenes de códigos de barras para la gestión de almacenes y el control de existencias con especificación de nombre de archivo.
- Catálogos de productos: Crear imágenes de códigos de barras para sistemas de identificación de productos y catálogos utilizando API integración
Casos de uso de logística y envío
- Etiquetas de envíoGenerar imágenes de códigos de barras independientes para el seguimiento y la entrega de paquetes utilizando el parámetro Tipo de código de barras.
- Identificación del paquete: Crea imágenes de códigos de barras únicas para cada envío a lo largo de las cadenas de suministro mediante el parámetro Texto.
- Sistemas de almacénGenerar imágenes de códigos de barras para ubicaciones de contenedores y seguimiento de inventario con especificación de nombre de archivo.
- Cadena de suministro: Crear imágenes de códigos de barras para el seguimiento de productos a través de redes de distribución utilizando API integración
Casos de uso en el sector sanitario y médico
- Identificación del pacienteGenerar imágenes de códigos de barras para pulseras de pacientes y registros médicos utilizando el parámetro Tipo de código de barras.
- Seguimiento de la medicación: Crear imágenes de códigos de barras para la identificación de medicamentos y la verificación de dosis mediante el parámetro Texto.
- Gestión de equiposGenerar imágenes de códigos de barras para el seguimiento de equipos médicos y activos con especificación de nombre de archivo.
- Seguimiento de muestras de laboratorio: Crear imágenes de códigos de barras para muestras de prueba e identificación de resultados utilizando API integración
Casos de uso en materia de gobierno y cumplimiento normativo
- Documentos de identidadGenerar imágenes de códigos de barras para licencias de conducir, pasaportes y tarjetas de identificación utilizando el parámetro Tipo de código de barras.
- Procesamiento de formularios: Crear imágenes de códigos de barras para formularios fiscales y documentación de cumplimiento mediante el parámetro Texto.
- Seguimiento de documentosGenerar imágenes de códigos de barras para el seguimiento reglamentario y los registros de auditoría con especificación de nombre de archivo.
- Registros públicos: Crear imágenes de códigos de barras para sistemas de identificación de documentos gubernamentales utilizando API integración
Casos de uso en educación y bibliotecas
- Tarjetas de estudianteGenerar imágenes de códigos de barras para la identificación de estudiantes y el acceso al campus utilizando el parámetro Tipo de código de barras.
- Sistemas de bibliotecas: Crear imágenes de códigos de barras para sistemas de identificación y préstamo de libros mediante el parámetro Texto.
- Seguridad de los exámenesGenerar imágenes de códigos de barras para la identificación e integridad de documentos de prueba con especificación de nombre de archivo.
- Servicios del campus: Crear imágenes de códigos de barras para el seguimiento de equipos y recursos utilizando API integración
Casos de uso en negocios y finanzas
- Sistemas de facturaciónGenerar imágenes de códigos de barras para el procesamiento y pago automatizado de facturas utilizando el parámetro Tipo de código de barras.
- Gestión de documentos: Crear imágenes de códigos de barras para la identificación de documentos comerciales mediante el parámetro Texto.
- Seguimiento de activosGenerar imágenes de códigos de barras para sistemas de gestión de equipos y activos con especificación de nombre de archivo.
- Documentación de cumplimiento: Cree imágenes de códigos de barras para registros de auditoría y registros financieros utilizando API integración