Códigos QR em JavaScript e Node.js: pacote npm para imagens ou serviço para códigos QR dinâmicos?

Bibliotecas de imagem do npm

Quem precisa de um código QR em JavaScript ou Node.js encontra muitas bibliotecas no npm. Transformam um texto numa imagem ou SVG, offline e sem serviço. Para conteúdos fixos, como identificadores de bilhetes ou dados de pagamento, é o ideal.

Quando precisas de mais

Uma imagem destas é estática. Se o destino deve poder mudar depois da impressão, se queres contar leituras ou saber quando um destino deixa de funcionar, precisas de um serviço para códigos QR dinâmicos. O Same-QR guarda o destino atrás de um endereço curto e constante, conta as leituras e verifica todos os destinos todas as noites.

A CLI sameqr do npm

O Same-QR tem um programa de linha de comandos próprio, sem dependências, a partir do Node.js 18:

npm install -g sameqr
sameqr login
sameqr qr create --name "Flyer Herbst" --url https://example.com/herbst --json

O «sameqr login» pede a tua chave de API de forma oculta. A chave crias no painel, em Conta, «Acesso para CLI, scripts e agentes». Em scripts, defines antes SAMEQR_API_KEY. Com --json, cada comando devolve uma saída que o teu script lê diretamente.

API REST a partir de Node.js

Para aplicações que geram códigos QR continuamente, falas diretamente com a API. Desde o Node.js 18 basta o fetch integrado:

const antwort = await fetch("https://sameqr.com/api/v1/qr", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.SAMEQR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ name: "Produkt 4711", targetUrl: "https://example.com/p/4711" }),
})
const daten = await antwort.json()
if (!antwort.ok) throw new Error(daten.error.message)
console.log(daten.id)

Importante em aplicações web: a chave nunca pode ir parar ao navegador. Os pedidos à API pertencem ao teu servidor.

Ajuda para decidir

• O conteúdo nunca muda, não é preciso estatística: biblioteca de imagem do npm.
• Muitos códigos QR de uma só vez: importação CSV no painel ou um script curto com a CLI sameqr.
• Fluxos recorrentes no terminal ou com um agente de programação: CLI sameqr com --json.
• Os códigos QR surgem continuamente na tua aplicação: API REST a partir do servidor.

Conclusão: porquê o Same-QR

O Same-QR encaixa em qualquer projeto JavaScript: uma CLI do npm sem dependências, uma API REST para fetch e um servidor MCP para agentes de programação, tudo em todos os planos. Assim obténs códigos QR dinâmicos com estatística, sem teres de gerir tu próprio um serviço de redirecionamento.

Começa já: regista-te gratuitamente em sameqr.com, 20 códigos QR dinâmicos são gratuitos para sempre. API, CLI e servidor MCP existem em todos os planos, a documentação está em sameqr.com/entwickler.

Perguntas frequentes