QR kod preko komandne linije: instalacija i korištenje sameqr CLI-ja

Zašto komandna linija

CLI (Command Line Interface) je program kojim upravljaš tekstualnim naredbama u terminalu. Naredba se može ponavljati, upisati u skriptu, povezati s drugim alatima i izvršiti preko coding agenta. CLI sameqr donosi Same-QR upravo tamo. Nema dodatnih zavisnosti i treba samo Node.js od verzije 18.

Korak 1: Instalacija

CLI dolazi preko npm-a, upravitelja paketa za Node.js:

npm install -g sameqr
sameqr --version

Korak 2: Napravi API ključ

Na kontrolnoj tabli pod Račun naći ćeš odjeljak „Pristup za CLI, skripte i agente“. Tamo napravi ključ. Za početak je dovoljno „čitanje + pisanje“: pravljenje, mijenjanje naziva i tekstova. Ko želi mijenjati i ciljeve postojećih QR kodova, isključivati stranice ili ih brisati, bira „potpuno“. Ključ počinje sa sqr_live_ i prikazuje se samo jednom. Odmah ga sačuvaj u svom upravitelju lozinki.

Korak 3: Prijava

Ključ se nikad ne predaje kao argument, inače bi ostao u historiji ljuske. „sameqr login“ ga traži skriveno, provjerava ga i pohranjuje tako da ga možeš čitati samo ti, u ~/.config/sameqr/config.json. Alternativno postavi varijablu okruženja SAMEQR_API_KEY, koja uvijek ima prednost.

sameqr login
sameqr whoami

„sameqr whoami“ prikazuje tvoj račun, paket i koliko QR kodova možeš napraviti.

Korak 4: Napravi prvi QR kod

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>

Opcijom --slug pri pravljenju određuješ vlastitu kratku vezu, opcijom --label dodaješ oznake. Njihove identifikatore prikazuje „sameqr labels list“. Promjena cilja, isključivanje i brisanje traže ključ „potpuno“. CLI tada pita u terminalu, a u skriptama bez terminala ide samo s izričitim --yes. Preko API-ja moguće je najviše 10 takvih promjena na sat i 30 na dan.

Korak 5: Gostujuće stranice i jelovnici

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“ ispisuje adresu nove stranice, u primjeru menu/gasthof-zum-loewen. Ona ti treba za sljedeće naredbe. Stranica nastaje kao skica. „karte import“ čita fotografije pomoću vještačke inteligencije i dodaje prepoznate grupe stranici, ne prepisujući ništa. Pregledaj skicu prije objave. Za objavu moraju biti popunjeni podaci o operateru. Posljednja naredba pravi QR kod koji vodi direktno na stranicu. Dodatni predlošci: preisliste, zeiten, links, aktion, weingut, etikett i kontakt.

Korak 6: U skriptama s --json

Ako naredbi dodaš --json, odgovor stiže kao JSON. Greške tada također završavaju kao JSON na izlazu za greške, a povratna vrijednost otkriva vrstu: 3 znači nije prijavljen, 4 nedostaju prava, 2 pogrešan unos. Tako skripta reaguje ciljano, umjesto da tumači tekst.

sameqr qr list --json

Zaključak: Zašto Same-QR

CLI sameqr donosi puni opseg funkcija Same-QR u terminal: QR kodove, statistiku, gostujuće stranice, jelovnike iz fotografija, oznake i projekte. Mali je, pažljivo postupa s tvojim ključem i govori JSON za skripte i coding agente. I radi u svakom paketu.

Počni odmah: registruj se besplatno na sameqr.com, 20 dinamičnih QR kodova trajno je besplatno. API, CLI i MCP server dostupni su u svakom paketu, a dokumentacija je na sameqr.com/entwickler.

Često postavljana pitanja