kodebar

SDK oficial da API Kodebar — consulta de produtos brasileiros por código de barras (GTIN/EAN).

Instalação

pip install kodebar

Uso rápido

from kodebar import Kodebar

kb = Kodebar("sua-api-key")

# Consultar um produto
produto = kb.lookup("7891234567890")
print(produto["nome"])       # "Produto Exemplo 500ml"
print(produto["thumbnail"])  # URL da imagem

# Buscar por nome
busca = kb.search("arroz integral")
for p in busca["results"]:
    print(p["gtin"], p["nome"])

# Autocomplete
sugestoes = kb.autocomplete("coca")

# Consulta em lote
lote = kb.bulk(["7891234567890", "7898765432100"])
print(f'{lote["found"]} encontrados, {lote["missed"]} não encontrados')

Configuração

kb = Kodebar("sua-api-key",
    timeout=15,       # timeout em segundos (default: 10)
    max_retries=3,    # retries em 429/5xx (default: 2)
)

Métodos

Tratamento de erros

from kodebar import Kodebar, KodebarNotFoundError, KodebarRateLimitError

kb = Kodebar("sua-api-key")

try:
    produto = kb.lookup("0000000000000")
except KodebarNotFoundError as e:
    print(f"Produto não encontrado: {e.gtin}")
except KodebarRateLimitError as e:
    print(f"Rate limit! Tente novamente em {e.retry_after} segundos")
except KodebarError as e:
    print(f"Erro: {e} (status: {e.status})")

Crie sua conta grátis

kodebar.korvensistemas.com.br/painel

Licença

MIT