Czym jest statyczny kod QR?
Statyczny kod QR zapisuje adres docelowy bezpośrednio w samym kodzie. Układ czarnych i białych modułów zawiera pełny adres URL — albo klucz WiFi, numer telefonu czy kontakt vCard.
Brzmi to prosto, ale wiąże się z istotną wadą: kod jest niezmienny. Jeśli chcesz zmienić adres URL, musisz wydrukować nowy kod.
Static: QR → "https://my-website.com/old-page"
↑ hardcoded
Kiedy statyczne kody mają sens
- Dane dostępowe WiFi (rzadko się zmieniają)
- vCard / dane kontaktowe
- Produkty ze stałym adresem URL karty technicznej
- EU DPP (cyfrowy paszport produktu) ze stałym GS1 Digital Link
- Środowiska offline, w których śledzenie nie jest potrzebne
Czym jest dynamiczny kod QR?
Dynamiczny kod QR zapisuje jedynie krótki link przekierowujący — na przykład https://qr3.app/r7f3Kx. Gdy ktoś zeskanuje taki kod, nasz edge worker w ciągu milisekund przekierowuje go do właściwego adresu docelowego.
Dynamic: QR → "https://qr3.app/r7f3Kx"
↓ (Cloudflare KV cache, < 5ms)
"https://my-website.com/new-page"
↑ changeable at any time
Zalety dynamicznych kodów QR
- Zmienny adres docelowy — żadnego ponownego drukowania przy zmianie URL
- Analityka skanowań — kraj, urządzenie, przeglądarka, znacznik czasu
- Testy A/B — różne adresy docelowe dla grup kampanii
- Geoprzekierowanie — użytkownicy z DE → strona w języku niemieckim
- Data wygaśnięcia — kod dezaktywowany po ustalonej dacie
- Webhooks — powiadomienie w czasie rzeczywistym przy każdym skanowaniu
Bezpośrednie porównanie
| Statyczny | Dynamiczny | |
|---|---|---|
| Zmienny cel | Nie | Tak |
| Analityka | Nie | Tak |
| Bramka skanowania (branding) | Nie | Opcjonalnie |
| Zgodność z RODO | Bez problemu | Tak (IP haszowane) |
| Użycie offline | Tak | Nie |
| Rozmiar pliku | Mniejszy | Większy |
| Zależność od serwera | Brak | Edge worker |
Praktyczna rekomendacja
Wybierz dynamiczny, gdy:
- Kod jest drukowany lub osadzany w materiałach
- Chcesz wiedzieć, jak często i skąd jest skanowany
- Może zajść potrzeba późniejszej aktualizacji adresu docelowego (menu, kampania itp.)
Wybierz statyczny, gdy:
- Dane są niezmienne (WiFi, vCard, GS1 DPP)
- Nie jest dostępna żadna infrastruktura serwerowa
- Potrzebna jest maksymalna rozdzielczość / najmniejszy rozmiar pliku
Wdrożenie z qr3.app
import { QR3 } from "@qr3/sdk";
const client = new QR3(process.env.QR3_API_KEY);
// Dynamic QR code
const dynamic = await client.codes.create({
type: "url",
url: "https://my-website.com/menu",
title: "Summer Menu 2026",
is_dynamic: true, // default
});
// Static QR code (e.g. vCard)
const vcard = await client.codes.create({
type: "vcard",
vcard_first_name: "John",
vcard_last_name: "Doe",
vcard_organization: "Example Corp",
// is_dynamic is ignored for non-URL types
});
console.log(dynamic.data.redirect_url); // https://qr3.app/r7f3Kx
console.log(dynamic.data.image_svg_url); // https://qr3.app/v1/codes/r7f3Kx/qr.svg
Podsumowanie
Dynamiczne kody QR to właściwy wybór dla większości zastosowań w druku, marketingu i handlu detalicznym. Statyczne kody zachowują swoje miejsce w zastosowaniach technicznych i scenariuszach offline. Dzięki qr3.app możesz zarządzać oboma typami za pomocą tego samego API i tego samego pulpitu.