Referencia de API

Genere códigos de barras Code 128 y GS1 mediante programación. API REST sencilla con respuestas JSON y descarga de imágenes.

Gratis: 100 solicitudes/día Business: 50,000 sol./mes

Inicio rápido

curl "https://www.barcode-code128.com/api/barcode/render?value=HELLO-WORLD&format=PNG&resolution=300" --output barcode.png

Endpoints

GET /api/barcode/render Descargar imagen de código de barras

Parámetro	Tipo	Predeterminado	Descripción
value	string	—	Requerido. El contenido del código de barras a codificar.
symbology	string	Code128Auto	Code128Auto, Code128A, Code128B, Code128C, GS1_128, GS1_DataMatrix, GS1_QR
format	string	PNG	PNG, SVG, PDF, EPS
resolution	int	300	DPI: 150, 300, 600, 1200
xDimension	decimal	0.33	Ancho del módulo en mm
barHeight	decimal	25.4	Altura de la barra en mm
showText	bool	true	Mostrar texto legible debajo del código de barras
foregroundColor	string	#000000	Color de las barras (hex)
backgroundColor	string	#FFFFFF	Color de fondo (hex)
barWidthReduction	decimal	0	Corrección de impresión en mm

POST /api/barcode/batch Generar varios códigos de barras en un archivo ZIP

Envíe un cuerpo JSON con un arreglo de valores. Devuelve un archivo ZIP con un código de barras por valor.

{
  "values": ["SKU-001", "SKU-002", "SKU-003"],
  "symbology": "Code128Auto",
  "format": "PNG",
  "resolution": 300
}

POST /api/gs1/render Generar código de barras GS1 con datos estructurados

Envíe campos de Identificador de Aplicación GS1. La API gestiona la codificación, separadores FNC1 y dígitos de control.

{
  "fields": [
    { "ai": "01", "value": "05412345000013" },
    { "ai": "10", "value": "LOT-A23" },
    { "ai": "17", "value": "260731" }
  ],
  "symbology": "GS1_128",
  "format": "PNG",
  "resolution": 300
}

GET /api/barcode/quota Consultar su consumo actual

{ "usedToday": 3, "dailyLimit": 5, "remaining": 2, "tier": "Free" }

Playground

Pruebe la API en vivo; no requiere registro.

Valor

Formato

DPI

cURL

Ejemplos de código

cURL

curl "https://www.barcode-code128.com\
/api/barcode/render\
?value=SKU-4711\
&format=PNG\
&resolution=300" \
  --output barcode.png

Python

import requests

resp = requests.get(
    "https://www.barcode-code128.com"
    "/api/barcode/render",
    params={
        "value": "SKU-4711",
        "format": "PNG",
        "resolution": 300
    }
)

with open("barcode.png", "wb") as f:
    f.write(resp.content)

Node.js

const fs = require('fs');

const url = new URL(
  "https://www.barcode-code128.com"
  + "/api/barcode/render"
);
url.searchParams.set("value", "SKU-4711");
url.searchParams.set("format", "PNG");
url.searchParams.set("resolution", "300");

const resp = await fetch(url);
const buf = await resp.arrayBuffer();
fs.writeFileSync(
  "barcode.png",
  Buffer.from(buf)
);