Kod QR z wiersza poleceń: instalacja i użycie CLI sameqr

Dlaczego wiersz poleceń

CLI (Command Line Interface) to program, który obsługujesz za pomocą poleceń tekstowych w terminalu. Polecenie można powtórzyć, wpisać do skryptu, połączyć z innymi narzędziami i uruchomić przez agenta programistycznego. CLI sameqr przenosi Same-QR właśnie tam. Nie ma dalszych zależności i wymaga tylko Node.js w wersji 18 lub nowszej.

Krok 1: instalacja

CLI instalujesz przez npm, menedżer pakietów Node.js:

npm install -g sameqr
sameqr --version

Krok 2: utwórz klucz API

W panelu w sekcji Konto znajdziesz część „Dostęp dla CLI, skryptów i agentów“. Utwórz tam klucz. Na początek wystarczy „odczyt + zapis“: tworzenie, zmiana nazw i tekstów. Kto chce też zmieniać cele istniejących kodów QR, wyłączać strony lub je usuwać, wybiera „pełny“. Klucz zaczyna się od sqr_live_ i jest wyświetlany tylko raz. Zapisz go od razu w menedżerze haseł.

Krok 3: zaloguj się

Klucza nigdy nie przekazuje się jako argumentu, bo inaczej znalazłby się w historii powłoki. „sameqr login“ pyta o niego w sposób ukryty, sprawdza go i zapisuje tak, by tylko ty mógł go odczytać, w ~/.config/sameqr/config.json. Alternatywnie ustawiasz zmienną środowiskową SAMEQR_API_KEY, która zawsze ma pierwszeństwo.

sameqr login
sameqr whoami

„sameqr whoami“ pokazuje twoje konto, plan i to, ile kodów QR możesz jeszcze utworzyć.

Krok 4: utwórz pierwszy kod QR

sameqr qr create --name "Speisekarte Tische" --url https://example.com/karte
sameqr qr list
sameqr qr update <id> --url https://example.com/winterkarte
sameqr qr stats <id>

Za pomocą --slug przy tworzeniu ustalasz własny krótki link, za pomocą --label dodajesz etykiety. Ich identyfikatory pokazuje „sameqr labels list“. Zmiana celu, wyłączanie i usuwanie wymagają klucza „pełny“. CLI pyta wtedy w terminalu, a w skryptach bez terminala działa to tylko z wyraźnym --yes. Przez API możliwe jest najwyżej 10 takich zmian na godzinę i 30 na dobę.

Krok 5: strony gościnne i karty dań

sameqr seite create --vorlage speisekarte --name "Gasthof zum Löwen"
sameqr karte import karte-1.jpg karte-2.jpg --seite menu/gasthof-zum-loewen
sameqr seite publish menu/gasthof-zum-loewen
sameqr qr create --name "Tischaufsteller" --seite menu/gasthof-zum-loewen

„seite create“ wypisuje adres nowej strony, w przykładzie menu/gasthof-zum-loewen. Będzie ci potrzebny w kolejnych poleceniach. Strona powstaje jako wersja robocza. „karte import“ wczytuje zdjęcia za pomocą AI i dołącza rozpoznane grupy do strony, niczego nie nadpisując. Przejrzyj wersję roboczą, zanim opublikujesz. Do publikacji muszą być wypełnione dane operatora. Ostatnie polecenie tworzy kod QR, który wskazuje bezpośrednio na stronę. Dalsze wzory: preisliste, zeiten, links, aktion, weingut, etikett i kontakt.

Krok 6: w skryptach z --json

Jeśli dopiszesz --json do polecenia, odpowiedź przyjdzie jako JSON. Błędy trafiają wtedy również jako JSON na wyjście błędów, a kod wyjścia zdradza ich rodzaj: 3 oznacza brak zalogowania, 4 brak uprawnień, 2 błędne dane wejściowe. Dzięki temu skrypt reaguje celnie, zamiast interpretować tekst.

sameqr qr list --json

Podsumowanie: dlaczego Same-QR

CLI sameqr przenosi pełny zakres funkcji Same-QR do terminala: kody QR, statystyki, strony gościnne, karty dań ze zdjęć, etykiety i projekty. Jest lekkie, starannie traktuje twój klucz i mówi w JSON dla skryptów i agentów programistycznych. I działa w każdym planie.

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

Najczęściej zadawane pytania