QR kod preko naredbenog retka: instalacija i korištenje sameqr CLI-ja

Zašto naredbeni redak

CLI (Command Line Interface) je program kojim upravljaš tekstualnim naredbama u terminalu. Naredbu možeš ponoviti, upisati u skriptu, povezati s drugim alatima i pustiti da je izvrši agent za programiranje. CLI sameqr donosi Same-QR upravo tamo. Nema dodatnih ovisnosti 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: Izradi API ključ

Na nadzornoj ploči pod Račun nalazi se odjeljak „Pristup za CLI, skripte i agente“. Tamo izradi ključ. Za početak je dovoljno „čitanje + pisanje“: izrada, mijenjanje naziva i tekstova. Tko želi i mijenjati odredišta postojećih QR kodova, isključivati stranice ili ih brisati, bira „potpuno“. Ključ počinje s sqr_live_ i prikazuje se samo jednom. Odmah ga spremi u svoj upravitelj lozinki.

Korak 3: Prijava

Ključ se nikad ne predaje kao argument, inače bi ostao u povijesti ljuske. „sameqr login“ traži ga skriveno, provjerava ga i sprema 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 još možeš izraditi.

Korak 4: Izradi 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 izradi određuješ vlastitu kratku poveznicu, opcijom --label dodaješ oznake. Njihove identifikatore prikazuje „sameqr labels list“. Promjena 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 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. Trebat će ti za sljedeće naredbe. Stranica nastaje kao skica. „karte import“ učitava fotografije pomoću AI-ja i dodaje prepoznate skupine na stranicu, bez prepisivanja ičega. Pregledaj skicu prije objave. Za objavu moraju biti ispunjeni podaci o pružatelju usluge. Posljednja naredba izrađuje QR kod koji vodi izravno na stranicu. Dodatni predlošci: preisliste, zeiten, links, aktion, weingut, etikett i kontakt.

Korak 6: U skriptama s --json

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

sameqr qr list --json

Zaključak: zašto Same-QR

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

Kreni odmah: registriraj se besplatno na sameqr.com, 20 dinamičnih QR kodova trajno je besplatno. API, CLI i MCP poslužitelj dostupni su u svakom paketu, a dokumentacija je na sameqr.com/entwickler.

Često postavljana pitanja