QR-Codes in JavaScript und Node.js: npm-Paket für Bilder oder Dienst für dynamische Codes?

Bildbibliotheken aus npm

Wer in JavaScript oder Node.js einen QR-Code braucht, findet auf npm viele Bibliotheken. Sie erzeugen aus einem Text ein Bild oder SVG, offline und ohne Dienst. Für feste Inhalte wie Ticketkennungen oder Zahlungsdaten ist das ideal.

Wann du mehr brauchst

Ein solches Bild ist statisch. Soll sich das Ziel nach dem Druck ändern lassen, willst du Scans zählen oder erfahren, wenn ein Ziel ausfällt, brauchst du einen Dienst für dynamische Codes. Same-QR speichert das Ziel hinter einer kurzen, gleichbleibenden Adresse, zählt Scans und prüft jede Nacht alle Ziele.

Die sameqr-CLI aus npm

Same-QR hat ein eigenes Kommandozeilenprogramm, ohne Abhängigkeiten, ab Node.js 18:

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

„sameqr login“ fragt deinen API-Schlüssel verdeckt ab. Den Schlüssel legst du im Dashboard unter Konto, „Zugang für CLI, Skripte und Agenten“, an. In Skripten setzt du stattdessen SAMEQR_API_KEY. Mit --json liefert jeder Befehl Ausgabe, die dein Skript direkt einliest.

REST-API aus Node.js

Für Anwendungen, die laufend Codes erzeugen, sprichst du die API direkt an. Seit Node.js 18 genügt das eingebaute fetch:

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)

Wichtig bei Webanwendungen: Der Schlüssel darf nie im Browser landen. Anfragen an die API gehören auf deinen Server.

Entscheidungshilfe

• Inhalt ändert sich nie, keine Statistik nötig: Bildbibliothek aus npm.
• Einmalig viele Codes: CSV-Import im Dashboard oder ein kurzes Skript mit der sameqr-CLI.
• Wiederkehrende Abläufe im Terminal oder mit einem Coding-Agent: sameqr-CLI mit --json.
• Codes entstehen laufend in deiner Anwendung: REST-API vom Server aus.

Fazit: Warum Same-QR

Same-QR passt in jedes JavaScript-Projekt: eine abhängigkeitsfreie CLI aus npm, eine REST-API für fetch und ein MCP-Server für Coding-Agents, alles in jedem Tarif. Damit bekommst du dynamische Codes mit Statistik, ohne selbst einen Weiterleitungsdienst zu betreiben.

Leg gleich los: Registriere dich kostenlos auf sameqr.com, zwei dynamische QR-Codes sind dauerhaft gratis. API, CLI und MCP-Server gibt es in jedem Tarif, die Dokumentation steht auf sameqr.com/entwickler.

Häufig gestellte Fragen