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

Zašto komandna linija

CLI (Command Line Interface) je program koji upravljaš tekstualnim komandama u terminalu. Komanda se može ponoviti, upisati u skriptu, povezati sa drugim alatima i izvršiti preko agenta za programiranje. CLI sameqr donosi Same-QR upravo tamo. Nema dodatnih zavisnosti i traži samo Node.js verzije 18 ili novije.

Korak 1: Instalacija

CLI dolazi preko npm-a, menadžera paketa za Node.js:

npm install -g sameqr
sameqr --version

Korak 2: Napravi API ključ

Na kontrolnoj tabli pod Nalog naći ćeš odeljak „Pristup za CLI, skripte i agente“. Tamo napravi ključ. Za početak je dovoljno „čitanje + pisanje“: kreiranje, izmena naziva i tekstova. Ko želi i da menja odredišta postojećih QR kodova, isključuje stranice ili ih briše, bira „potpuno“. Ključ počinje sa sqr_live_ i prikazuje se samo jednom. Odmah ga sačuvaj u menadžeru lozinki.

Korak 3: Prijava

Ključ se nikad ne prosleđuje kao argument, inače bi završio u istoriji komandi ljuske. „sameqr login“ ga traži skriveno, proverava ga i čuva tako da ga možeš čitati samo ti, u ~/.config/sameqr/config.json. Alternativno postaviš promenljivu okruženja SAMEQR_API_KEY, koja uvek ima prednost.

sameqr login
sameqr whoami

„sameqr whoami“ prikazuje tvoj nalog, paket i koliko QR kodova možeš da kreiraš.

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>

Sa --slug pri kreiranju određuješ sopstveni kratak link, sa --label dodaješ oznake. Njihove identifikatore prikazuje „sameqr labels list“. Promena odredišta, isključivanje i brisanje traže ključ „potpuno“. CLI tada pita u terminalu, a u skriptama bez terminala radi samo uz izričito --yes. Preko API-ja je moguće najviše 10 takvih izmena 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 primeru menu/gasthof-zum-loewen. Ona ti treba za naredne komande. Stranica nastaje kao nacrt. „karte import“ učitava fotografije pomoću veštačke inteligencije i dodaje prepoznate grupe na stranicu, bez prepisivanja bilo čega. Pregledaj nacrt pre objavljivanja. Za objavljivanje moraju biti popunjeni podaci o operateru. Poslednja komanda kreira QR kod koji vodi direktno na stranicu. Dodatni šabloni: preisliste, zeiten, links, aktion, weingut, etikett i kontakt.

Korak 6: U skriptama sa --json

Ako komandi dodaš --json, odgovor stiže kao JSON. Greške tada takođe stižu kao JSON na izlaz za greške, a povratna vrednost otkriva vrstu: 3 znači nije prijavljen, 4 nedostaju prava, 2 pogrešan unos. Tako skripta reaguje ciljano, umesto da tumači tekst.

sameqr qr list --json

Zaključak: Zašto Same-QR

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

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

Često postavljana pitanja