QR kód z příkazového řádku: instalace a použití CLI sameqr

Proč příkazový řádek

CLI (Command Line Interface) je program, který ovládáš textovými příkazy v terminálu. Příkaz lze opakovat, vložit do skriptu, řetězit s jinými nástroji a nechat provést programovacím agentem. CLI sameqr přináší Same-QR přesně tam. Nemá žádné další závislosti a potřebuje jen Node.js od verze 18.

Krok 1: Instalace

CLI se instaluje přes npm, správce balíčků Node.js:

npm install -g sameqr
sameqr --version

Krok 2: Vytvoř klíč API

V dashboardu v části Účet najdeš oddíl „Přístup pro CLI, skripty a agenty“. Vytvoř tam klíč. Na začátek stačí „čtení + zápis“: vytvářet, měnit názvy a texty. Kdo chce také měnit cíle existujících QR kódů, stahovat stránky z provozu nebo je mazat, zvolí „plná“. Klíč začíná na sqr_live_ a zobrazí se jen jednou. Ulož si ho hned do správce hesel.

Krok 3: Přihlášení

Klíč se nikdy nepředává jako argument, jinak by zůstal v historii shellu. „sameqr login“ se na něj zeptá skrytě, ověří ho a uloží ho čitelný jen pro tebe do ~/.config/sameqr/config.json. Případně nastavíš proměnnou prostředí SAMEQR_API_KEY, která má vždy přednost.

sameqr login
sameqr whoami

„sameqr whoami“ ukáže tvůj účet, tarif a kolik QR kódů můžeš vytvořit.

Krok 4: Vytvoř první QR kód

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>

Pomocí --slug při vytváření určíš vlastní krátký odkaz, pomocí --label připojíš štítky. Jejich identifikátory ukáže „sameqr labels list“. Změna cíle, stažení z provozu a mazání vyžadují klíč „plná“. CLI se pak zeptá v terminálu, ve skriptech bez terminálu to jde jen s výslovným --yes. Přes API je možných nejvýše 10 takových změn za hodinu a 30 za den.

Krok 5: Stránky pro hosty a jídelní lístky

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“ vypíše adresu nové stránky, v příkladu menu/gasthof-zum-loewen. Tu budeš potřebovat pro další příkazy. Stránka vznikne jako koncept. „karte import“ načte fotky pomocí AI a rozpoznané skupiny připojí ke stránce, aniž by cokoli přepsal. Koncept si projdi, než ho zveřejníš. Pro zveřejnění musí být vyplněné údaje o provozovateli. Poslední příkaz vytvoří QR kód, který míří přímo na stránku. Další šablony: preisliste, zeiten, links, aktion, weingut, etikett a kontakt.

Krok 6: Ve skriptech s --json

Když k příkazu připojíš --json, odpověď přijde jako JSON. Chyby pak také přijdou jako JSON na chybovém výstupu a návratová hodnota prozradí druh: 3 znamená nepřihlášen, 4 chybějící oprávnění, 2 chybný vstup. Skript tak reaguje cíleně, místo aby luštil text.

sameqr qr list --json

Závěr: Proč Same-QR

CLI sameqr přináší plný rozsah funkcí Same-QR do terminálu: QR kódy, statistiky, stránky pro hosty, jídelní lístky z fotek, štítky a projekty. Je štíhlé, s tvým klíčem zachází pečlivě a pro skripty a programovací agenty mluví JSON. A funguje v každém tarifu.

Začni hned: zaregistruj se zdarma na sameqr.com, 20 dynamických QR kódů je trvale zdarma. API, CLI a server MCP jsou v každém tarifu, dokumentace je na sameqr.com/entwickler.

Často kladené otázky