Generator kodów QR — URL, WiFi, vCard, e-mail, SMS, geo

Czym jest kod QR?

// Build a WiFi payload and generate an SVG QR
import QRCode from 'qrcode';

// 1. WIFI: protocol (de facto, recognized by iOS+Android)
const payload = 'WIFI:T:WPA;S:My\\;Network;P:p@ss\\;word;H:false;;';

// 2. Generate SVG (vector, scales without pixelation)
const svg = await QRCode.toString(payload, {
  type: 'svg',
  errorCorrectionLevel: 'M',
  margin: 4,
  color: { dark: '#000000', light: '#ffffff' },
});

// 3. Drop into the DOM (DOMParser-safe, not innerHTML)
const doc = new DOMParser().parseFromString(svg, 'image/svg+xml');
preview.replaceChildren(doc.documentElement);

Główne funkcje

Przykłady

https://go-tools.org

SSID: Cafe WiFi / WPA2 / hasło: visitor2026

Ada Lovelace / Acme Corp / +1 555 0100 / ada@acme.test

lat: 40.7829, lng: -73.9654 (Central Park)

Jak używać

1. 1

   Wybierz typ danych

   Wybierz zakładkę odpowiadającą temu, co kodujesz: URL dla stron WWW, WiFi do udostępniania sieci, vCard dla danych kontaktowych, Email lub SMS dla wstępnie wypełnionych wiadomości, Location dla pinezek mapowych lub Plain Text dla dowolnej zawartości.

2. 2

   Wypełnij pola

   Każda zakładka pokazuje odpowiednie pola dla danego typu. WiFi wymaga SSID, hasła i typu zabezpieczeń. vCard akceptuje imię, telefon, e-mail, organizację i stronę WWW. Podgląd kodu QR aktualizuje się w trakcie pisania.

3. 3

   Dostosuj (opcjonalnie)

   Otwórz panel Customize, aby zmienić poziom korekcji błędów (M jest dobre w większości przypadków, H do druku), rozmiar wyjścia (200-1024 px) oraz kolory pierwszego planu/tła. Narzędzie ostrzega, gdy kontrast jest zbyt niski, by skanować niezawodnie.

4. 4

   Pobierz SVG lub PNG

   Kliknij Download SVG, by uzyskać wyjście wektorowe (skalowalne, idealne do druku) lub wybierz rozmiar PNG (256/512/1024 px) z listy rozwijanej. Użyj Copy SVG, by wkleić bezpośrednio do Figma lub innego narzędzia projektowego.

Typowe błędy kodów QR

QR encodes: https://bit.ly/abc → 404 after subscription lapses

QR encodes: https://your-domain.com/menu directly

FG #cccccc on BG #ffffff (ratio 1.6:1)

FG #003366 on BG #ffffff (ratio 12.6:1)

WIFI:T:WPA;S:Cafe;P:p@ss;word;; (parser breaks at the unescaped ;)

WIFI:T:WPA;S:Cafe;P:p@ss\;word;;

Print poster, ECC=L, partially folded → unreadable

Print poster, ECC=H → readable even with 30% damage

40% logo over center → fails on Samsung phones

15% logo, ECC=H → reliable across phones

?utm_source=...&utm_medium=...&utm_campaign=... (350 chars at M → reject)

Use /go/spring (35 chars) with server-side redirect to the long URL

Typowe przypadki użycia

Menu restauracji

Wydrukuj kod QR z URL-em na stoliku — klienci przeglądają menu na swoich telefonach. Statyczny QR oznacza, że działa nawet po zmianie dostawcy hostingu lub domeny menu.

WiFi dla gości

Przyklej kod QR WiFi przy drzwiach w domu, w kawiarniach lub salach konferencyjnych. Goście skanują i dołączają bez wpisywania hasła — a ty nigdy nie musisz go odczytywać na głos.

Rejestracja na wydarzeniach

Wydrukuj kod QR z URL-em prowadzącym do strony rejestracji na biletach i oznakowaniu. Pojawia się na zdjęciach fotografa, identyfikatorach, smyczach — każde skanowanie to śledzona rejestracja.

Wizytówki

Dodaj kod QR vCard do papierowych wizytówek — skanowanie zapisuje twój kontakt natychmiast. Około 4× wyższy wskaźnik zapisu niż prośba o ręczne wpisanie danych do telefonu.

Pinezki lokalizacji dla obiektów

Kody QR geo: otwierają domyślną aplikację map z już ustawioną pinezką. Stosuj je w ofertach nieruchomości, ulotkach restauracji, oznakowaniu konferencji i zaproszeniach ślubnych.

Plakaty marketingowe

Kody QR z parametrami UTM śledzą atrybucję kampanii drukowanej. Statyczny QR przetrwa, nawet jeśli serwis analityczny kampanii zostanie zamknięty lub twoje konto wygaśnie.

Opakowania produktów

Zakoduj URL-e gwarancji, instrukcji lub rejestracji na pudełku. Użyj korekcji błędów H, by kod QR przetrwał uszkodzenia transportowe, zarysowania i zagięcia klap.

Etykiety muzealne i wystawowe

URL-e przewodników audio, głębszy kontekst, alternatywy językowe — zwiedzający uzyskują bogatą zawartość z własnego telefonu zamiast nosić obszerne drukowane broszury.

Szczegóły techniczne

Zgodne z ISO/IEC 18004:2015

Wyjście jest zgodne z międzynarodowym standardem QR Code. Wersje od 1 do 40 (21×21 do 177×177 modułów) wybierane automatycznie na podstawie rozmiaru zawartości i wybranego poziomu korekcji błędów.

Korekcja błędów Reed-Solomon

Kody QR używają kodowania Reed-Solomon, by odzyskać dane po uszkodzeniu lub zasłonięciu. Poziomy L/M/Q/H odzyskują z grubsza 7%, 15%, 25% i 30% uszkodzonych danych. Wyższe poziomy oznaczają większy QR dla tej samej zawartości.

Standardowe schematy URI

Protokół WIFI: (de facto, rozpoznawany przez iOS i Android), mailto: (RFC 6068), sms: (RFC 5724), geo: (RFC 5870). Wizytówki używają vCard 3.0 (RFC 2426) — szersza zgodność skanerów niż vCard 4.0 (RFC 6350). Wbudowane aplikacje aparatu iOS i Android rozpoznają je wszystkie.

Tryb automatycznego kodowania

Biblioteka qrcode wybiera najefektywniejsze kodowanie (numeric, alphanumeric, byte lub kanji) dla każdego wejścia. Tryb byte UTF-8 obsługuje tekst spoza ASCII, w tym emoji i znaki CJK.

Najlepsze praktyki

Nie obcinaj strefy ciszy

Kody QR potrzebują marginesu tła o szerokości 4 modułów wokół siebie. To narzędzie zawiera go domyślnie — nie obcinaj go przy umieszczaniu kodu QR w layoucie, nawet jeśli wygląda na zmarnowane białe pole.

Używaj poziomu ECC H do druku

Druk jest bezlitosny — blaknięcie, zarysowania i linie zagięć uszkadzają kod. Poziom korekcji błędów H (~30% odzysku) ratuje cię. Poziom M jest w porządku dla ekranów, które się nie degradują.

Utrzymuj stosunek kontrastu 4,5:1 lub wyższy

Skanery QR mierzą kontrast między ciemnymi i jasnymi modułami. Trzymaj się ciemnego pierwszego planu na jasnym tle. Odwrócone (jasny na ciemnym) działa na niektórych telefonach, ale zawodzi na innych.

Testuj na iOS i Android

iOS Camera czyta kody QR domyślnie od iOS 11. Android różni się w zależności od producenta — Samsung, Pixel i Xiaomi zachowują się nieco odmiennie. Przetestuj oba przed wydrukowaniem 10 000 ulotek.

Używaj HTTPS i krótkich URL-i

Długie URL-e zagęszczają kod QR (mniejsze moduły → trudniejsze skanowanie). Jeśli twój URL śledzący ma 200+ znaków, przepuść go przez statyczny skracacz URL pod twoją kontrolą — nie Bitly, bo te wygasają.

Często zadawane pytania