Referência da API

Geração programática de códigos de barras Code 128 e GS1. API REST simples com respostas JSON e download de imagens.

Grátis: 100 req./dia Business: 50.000 req./mês

Início 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 Baixar imagem de código de barras

Parâmetro	Tipo	Padrão	Descrição
value	string	—	Obrigatório. O conteúdo do código de barras a ser codificado.
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	Largura do módulo da barra em mm
barHeight	decimal	25.4	Altura da barra em mm
showText	bool	true	Exibir texto legível abaixo do código de barras
foregroundColor	string	#000000	Cor da barra (hex)
backgroundColor	string	#FFFFFF	Cor de fundo (hex)
barWidthReduction	decimal	0	Compensação de impressão em mm

POST /api/barcode/batch Gerar vários códigos de barras em ZIP

Envio de um corpo JSON com uma matriz de valores. A resposta é um arquivo ZIP com um código de barras por valor.

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

POST /api/gs1/render Gerar código de barras GS1 de dados estruturados

Envio de campos de Identificador de Aplicação GS1. A API processa a codificação, os separadores FNC1 e os dígitos verificadores.

{
  "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 uso atual

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

Playground

Teste da API em tempo real — cadastro não necessário.

Valor

Formato

DPI

cURL

Exemplos 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)
);