← Wróć do bloga
AI i automatyzacja2 min czytania

Kody QR w JavaScript i Node.js: pakiet npm do obrazków czy usługa do dynamicznych kodów QR?

Zdjęcie z Unsplash

Biblioteki graficzne z npm

Jeśli potrzebujesz kodu QR w JavaScript lub Node.js, na npm znajdziesz wiele bibliotek. Zamieniają tekst na obrazek lub SVG, offline i bez żadnej usługi. Przy stałych treściach, takich jak numery biletów czy dane płatności, to idealne rozwiązanie.

Kiedy potrzebujesz więcej

Taki obrazek jest statyczny. Jeśli chcesz zmienić cel po wydruku, liczyć skany albo dowiedzieć się, że cel przestał działać, potrzebujesz usługi do dynamicznych kodów QR. Same-QR zapisuje cel za krótkim, niezmiennym adresem, liczy skany i co noc sprawdza wszystkie cele.

sameqr-CLI z npm

Same-QR ma własny program wiersza poleceń, bez zależności, od Node.js 18:

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

„sameqr login” prosi o twój klucz API z ukrytym wpisywaniem. Klucz utworzysz w panelu w sekcji Konto, „Dostęp dla CLI, skryptów i agentów”. W skryptach ustaw zamiast tego SAMEQR_API_KEY. Z opcją --json każde polecenie zwraca dane, które twój skrypt odczyta bezpośrednio.

REST API z Node.js

W aplikacjach, które stale generują kody QR, łączysz się z API bezpośrednio. Od Node.js 18 wystarczy wbudowany 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)

Ważne w aplikacjach webowych: klucz nigdy nie może trafić do przeglądarki. Zapytania do API należą do twojego serwera.

Pomoc w wyborze

  • Treść nigdy się nie zmienia, statystyki niepotrzebne: biblioteka graficzna z npm.
  • Jednorazowo wiele kodów QR: import CSV w panelu albo krótki skrypt z sameqr-CLI.
  • Powtarzalne zadania w terminalu lub z agentem programistycznym: sameqr-CLI z --json.
  • Kody QR powstają stale w twojej aplikacji: REST API z serwera.

Podsumowanie: dlaczego Same-QR

Same-QR pasuje do każdego projektu w JavaScript: CLI z npm bez zależności, REST API dla fetch i serwer MCP dla agentów programistycznych, wszystko w każdym planie. Dzięki temu dostajesz dynamiczne kody QR ze statystykami, bez własnej usługi przekierowań.

Zacznij od razu: zarejestruj się za darmo na sameqr.com, 20 dynamicznych kodów QR jest na stałe bezpłatne. API, CLI i serwer MCP są w każdym planie, dokumentacja jest na sameqr.com/entwickler.

Twórz dynamiczne kody QR za darmo
Zacznij od 20 dynamicznych kodów QR, które są darmowe na zawsze. Bez subskrypcji, bez karty kredytowej.
Zacznij za darmo →

Najczęściej zadawane pytania

Czy mogę używać sameqr-CLI w projekcie Node.js?

Tak. Działa od Node.js 18 i można ją wywoływać ze skryptów. Z --json dostajesz dane łatwe do przetworzenia.

Czy mogę używać klucza API we froncie?

Nie. Wszystko, co działa w przeglądarce, może odczytać każdy odwiedzający. Zapytania z kluczem należą do serwera.

Czy kody QR z biblioteki npm są gorsze?

Nie są gorsze, tylko statyczne. Przy stałych treściach są idealne, ale nie przy drukowanych kodach QR ze zmiennym celem.

Newsletter

Nowe artykuły prosto na Twoją skrzynkę

Wskazówki o dynamicznych kodach QR, nowości, bez spamu. Wypisać się można w każdej chwili.

Zapisując się, wyrażasz zgodę na otrzymywanie newslettera. Zgodę możesz w każdej chwili wycofać za pomocą linku do wypisania się w każdej wiadomości.

Czytaj dalej