Códigos QR en JavaScript y Node.js: ¿paquete npm para imágenes o servicio para códigos QR dinámicos?
Bibliotecas de imágenes de npm
Quien necesita un código QR en JavaScript o Node.js encuentra muchas bibliotecas en npm. Convierten un texto en una imagen o un SVG, sin conexión y sin ningún servicio. Para contenidos fijos, como identificadores de entradas o datos de pago, es ideal.
Cuándo necesitas más
Una imagen así es estática. Si quieres poder cambiar el destino después de imprimir, contar escaneos o enterarte de cuándo falla un destino, necesitas un servicio para códigos QR dinámicos. Same-QR guarda el destino detrás de una dirección corta y constante, cuenta los escaneos y comprueba todos los destinos cada noche.
La CLI de sameqr desde npm
Same-QR tiene su propio programa de línea de comandos, sin dependencias, a partir de Node.js 18:
npm install -g sameqr
sameqr login
sameqr qr create --name "Flyer Herbst" --url https://example.com/herbst --json“sameqr login” te pide tu clave de API de forma oculta. La clave la creas en el panel, en Cuenta, “Acceso para CLI, scripts y agentes”. En los scripts defines en su lugar SAMEQR_API_KEY. Con --json, cada comando devuelve una salida que tu script puede leer directamente.
API REST desde Node.js
Para aplicaciones que generan códigos QR de forma continua, te comunicas directamente con la API. Desde Node.js 18 basta el 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 en las aplicaciones web: la clave nunca debe acabar en el navegador. Las solicitudes a la API deben ir desde tu servidor.
Ayuda para decidir
- El contenido nunca cambia y no hacen falta estadísticas: biblioteca de imágenes de npm.
- Muchos códigos QR de una sola vez: importación CSV en el panel o un script corto con la CLI de sameqr.
- Procesos recurrentes en el terminal o con un agente de programación: CLI de sameqr con --json.
- Los códigos QR se generan de forma continua en tu aplicación: API REST desde el servidor.
Conclusión: por qué Same-QR
Same-QR encaja en cualquier proyecto de JavaScript: una CLI de npm sin dependencias, una API REST para fetch y un servidor MCP para agentes de programación, todo en todas las tarifas. Así obtienes códigos QR dinámicos con estadísticas, sin tener que operar tú mismo un servicio de redirección.
Empieza ya: regístrate gratis en sameqr.com, 20 códigos QR dinámicos son gratuitos para siempre. La API, la CLI y el servidor MCP están disponibles en todas las tarifas, y la documentación está en sameqr.com/entwickler.
Preguntas frecuentes
Sí. Funciona a partir de Node.js 18 y se puede invocar desde scripts. Con --json obtienes una salida procesable.
No. Todo lo que se ejecuta en el navegador lo puede leer cualquier visitante. Las solicitudes con clave deben ir desde el servidor.
No son peores, solo estáticos. Para contenidos fijos son ideales; para códigos QR impresos con un destino cambiante, no.
Nuevos artículos directamente en tu bandeja
Consejos sobre códigos QR dinámicos, novedades, sin spam. Puedes darte de baja en cualquier momento.
Al suscribirte aceptas recibir el newsletter. Puedes retirar tu consentimiento en cualquier momento con el enlace de baja que incluye cada correo.