API de imagens de código de barras
Uma URL, uma imagem de código de barras — sem chave, sem SDK e sem cadastro. Aponte para ela uma tag HTML <img>, um link de Markdown ou uma fórmula de planilha e pronto, funciona.
Ao vivo — esta imagem está sendo gerada agora mesmo pelo endpoint abaixo.
https://www.barcodesheets.com/api/barcode?data=SKU-12345&type=code128Parâmetros
| Parâmetro | Padrão | Limites | Descrição |
|---|---|---|---|
| data | obrigatório | 1–256 caracteres | O valor a codificar. Os dígitos verificadores (EAN-13, UPC-A, ITF-14, ISBN, …) são completados automaticamente — a mesma regra do gerador do site. Codifique os caracteres especiais na URL (um + literal é lido como espaço, conforme a convenção usual das cadeias de consulta que todos os consumidores de URL e de =IMAGE() já esperam). |
| type | code128 | um id de simbologia aceito (ver a tabela abaixo) | Que simbologia de código de barras é renderizada. |
| scale | 3 | 1–8 | Multiplicador da largura de módulo. Valores mais altos dão uma imagem maior e de maior resolução — aumente para imprimir, diminua para uma inserção pequena dentro do texto. |
| fmt | png | png ou svg | Formato de imagem devolvido. O SVG escala para qualquer tamanho sem perder qualidade; o PNG é a opção padrão mais segura para planilhas e CMS que não exibem SVG. |
| addon | nenhum | exatamente 5 dígitos — só com isbn | Complemento de preço EAN-5, aplicado apenas com type=isbn (equivale ao campo de complemento de preço do gerador de ISBN). É ignorado em qualquer outro tipo. |
| text | valor padrão da simbologia | 0 ou 1 | Se os caracteres legíveis são impressos abaixo das barras. text=0 força só barras; text=1 força a linha de texto; se você omitir, vale o valor padrão de cada simbologia (ligado na maioria dos tipos, desligado em Data Matrix/QR). Qualquer outro valor devolve um 400. |
Trechos para copiar e colar
<img src="https://www.barcodesheets.com/api/barcode?data=SKU-12345&type=code128" alt="Barcode for SKU-12345" width="300" height="100" />=IMAGE("https://www.barcodesheets.com/api/barcode?data=SKU-12345&type=code128")O que este endpoint faz
GET /api/barcode aceita os mesmos parâmetros data/type/scale que o gerador do site usa e devolve uma imagem de código de barras de verdade, já renderizada — PNG por padrão, ou SVG com fmt=svg — em vez de uma página web. Aponte para essa URL qualquer tag HTML <img>, um link de imagem de Markdown ou uma fórmula =IMAGE() de planilha, e o código de barras aparece onde quer que a URL esteja embutida, sem passos intermediários de baixar e enviar de novo. Os dígitos verificadores são completados automaticamente nos tipos da família GTIN, igual ao gerador — um data= de 12 dígitos com type=ean13 vira, na imagem devolvida, um EAN-13 real de 13 dígitos que é lido sem problema.
Uso razoável — limites generosos e sem chave
Não há conta, nem chave de API, nem autenticação de espécie alguma — todos os parâmetros de que você precisa estão na própria URL. Os limites são generosos de propósito, em vez de tarifados: até 256 caracteres em data= e uma faixa de scale= de 1 a 8. Cada resposta bem-sucedida leva o cabeçalho Cache-Control: public, max-age=31536000, s-maxage=31536000, immutable, então essa mesma URL fica em cache por um ano tanto nos navegadores quanto nas CDNs — uma planilha com mil linhas apontando para este endpoint renderiza cada código de barras único uma única vez. O abuso de verdade é assunto da plataforma de hospedagem, e não algo imposto por esta rota. O CORS também está completamente aberto (Access-Control-Allow-Origin: * em cada resposta, de sucesso ou de erro), então fazer fetch() da URL a partir do JavaScript de outro site — para desenhá-la em um <canvas> ou embuti-la como data URL, e não só como uma tag HTML <img> — também funciona de qualquer origem.
Tipos de código de barras aceitos
| type= | Código de barras | Categoria |
|---|---|---|
| code128 | Code 128 | General |
| code39 | Code 39 | General |
| ean13 | EAN-13 | Retail |
| ean8 | EAN-8 | Retail |
| upca | UPC-A | Retail |
| upce | UPC-E | Retail |
| itf14 | ITF-14 | Logistics |
| gs1-128 | GS1-128 | Logistics |
| datamatrix | Data Matrix | 2D |
| qrcode | QR Code | 2D |
| isbn | ISBN | Retail |
Perguntas frequentes
A API de código de barras é grátis?
GET /api/barcode é grátis e sem limite — sem chave de API, sem conta e sem teto por requisição. É um endpoint de imagens público, feito para você apontar a partir de uma planilha, de um CMS ou de um README, igual a qualquer outra URL de imagem.Dá para usar no Planilhas Google?
=IMAGE("https://www.barcodesheets.com/api/barcode?data=SEU-VALOR&type=code128") em uma célula (ou aponte data= para o valor de outra célula) e o código de barras aparece ali mesmo, atualizando-se sozinho se o valor mudar. O Excel 365 (conectado à nuvem) aceita a mesma fórmula =IMAGE().Existe algum limite de requisições?
Que tipos de código de barras a API aceita?
type= que aparece na lista de tipos abaixo e na página de cada simbologia (p. ex. /isbn para o id isbn).Continue explorando
Gere centenas de códigos de barras de uma vez a partir de uma planilha.
Imprimir folhas de etiquetasPDFs prontos para Avery com zonas de silêncio corretas, alinhados sozinhos.
Todos os tipos de código de barrasConheça todas as simbologias com que o BarcodeSheets é compatível.