Pular para o conteúdo principal

​
Endpoint

POST https://api.bunny.build/api/v1/barcode

​
Autenticação

HeaderObrigatórioValor
X-API-KeySimSua chave de API (bun_...)
Content-TypeSimapplication/json

​
Visão geral

Gere códigos de barras e QR codes sob demanda. A API de Barcode da Bunny converte qualquer texto ou URL em uma imagem pixel-perfect: QR codes, Code 128, EAN-13, PDF417, Data Matrix e muito mais. Retorna um PNG em base64 pronto para incorporar em páginas web, PDFs ou fluxos de impressão.

​
Casos de uso

  • Etiquetas de produtos e gestão de estoque
  • Geração de QR codes para links e cartões de contato
  • Impressão de códigos de barras para logística e envios
  • Ingressos para eventos e passes de acesso

​
Detalhes

Tipos suportados: qrcode, code128, code39, ean13, ean8, upca, upce, pdf417, datamatrix, azteccode, interleaved2of5. O parâmetro scale (1–10) controla o tamanho da imagem.

​
Corpo da requisição

CampoTipoObrigatórioDescrição
typestringSimTipo do código de barras (ex.: qrcode, code128, ean13)
datastringSimDados a codificar no código de barras
scalenumberNãoFator de escala da imagem gerada (padrão: 1)

​
Exemplo

{
  "type": "qrcode",
  "data": "https://example.com",
  "scale": 2
}

​
Resposta

​
200 OK

CampoTipoDescrição
imagestringImagem do código de barras em Base64
formatstringFormato da imagem (ex.: png)
typestringTipo de código de barras utilizado
datastringDados codificados
Exemplo 
{
  "image": "iVBORw0KGgoAAAANSUhEUgAA...",
  "format": "png",
  "type": "qrcode",
  "data": "https://example.com"
}

​
401 Unauthorized

{
  "detail": "Missing API key. Include X-API-Key header."
}

​
402 Payment Required

{
  "detail": "Monthly quota exceeded. Upgrade your plan."
}

​
422 Unprocessable Entity

{
  "detail": "Invalid barcode type or data"
}

​
429 Too Many Requests

{
  "detail": "Rate limit exceeded. Try again in 60 seconds."
}

​
Exemplo cURL

curl -X POST https://api.bunny.build/api/v1/barcode \
  -H "X-API-Key: bun_sua_chave_api" \
  -H "Content-Type: application/json" \
  -d '{"type": "qrcode", "data": "https://example.com", "scale": 2}'