QR koda iz ukazne vrstice: namesti in uporabljaj sameqr CLI

Zakaj ukazna vrstica

CLI (Command Line Interface) je program, ki ga upravljaš z besedilnimi ukazi v terminalu. Ukaz lahko ponoviš, zapišeš v skripto, povežeš z drugimi orodji in ga izvede programerski agent. CLI sameqr prinese Same-QR prav tja. Nima dodatnih odvisnosti in potrebuje samo Node.js od različice 18 naprej.

Korak 1: Namestitev

CLI dobiš prek npm, upravitelja paketov za Node.js:

npm install -g sameqr
sameqr --version

Korak 2: Ustvari ključ API

V nadzorni plošči pod Račun najdeš razdelek »Dostop za CLI, skripte in agente«. Tam ustvari ključ. Za začetek zadošča »branje + pisanje«: ustvarjanje, spreminjanje imen in besedil. Kdor želi spreminjati tudi cilje obstoječih QR kod, strani umikati s spleta ali jih brisati, izbere »polno«. Ključ se začne s sqr_live_ in se prikaže samo enkrat. Takoj ga shrani v upravitelj gesel.

Korak 3: Prijava

Ključa nikoli ne podaš kot argument, sicer bi ostal v zgodovini lupine. »sameqr login« ga vpraša skrito, ga preveri in shrani tako, da ga lahko bereš samo ti, v ~/.config/sameqr/config.json. Lahko pa nastaviš okoljsko spremenljivko SAMEQR_API_KEY, ki ima vedno prednost.

sameqr login
sameqr whoami

»sameqr whoami« prikaže tvoj račun, tarif in koliko QR kod lahko še ustvariš.

Korak 4: Ustvari prvo QR kodo

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>

Z --slug ob ustvarjanju določiš lastno kratko povezavo, z --label dodaš oznake. Njihove identifikatorje pokaže »sameqr labels list«. Za spreminjanje cilja, umik s spleta in brisanje potrebuješ ključ »polno«. CLI te nato vpraša v terminalu, v skriptah brez terminala pa gre samo z izrecnim --yes. Prek API-ja je možnih največ 10 takih sprememb na uro in 30 na dan.

Korak 5: Gostujoče strani in jedilniki

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« izpiše naslov nove strani, v primeru menu/gasthof-zum-loewen. Potrebuješ ga za naslednje ukaze. Stran nastane kot osnutek. »karte import« prebere fotografije z AI in prepoznane skupine doda na stran, ne da bi karkoli prepisal. Osnutek preglej, preden objaviš. Za objavo morajo biti izpolnjeni podatki o upravljavcu. Zadnji ukaz ustvari QR kodo, ki kaže neposredno na stran. Druge predloge: preisliste, zeiten, links, aktion, weingut, etikett in kontakt.

Korak 6: V skriptah z --json

Če ukazu dodaš --json, odgovor pride kot JSON. Napake se tedaj prav tako izpišejo kot JSON na izhod za napake, vrnjena vrednost pa pove vrsto: 3 pomeni ni prijave, 4 manjkajoče pravice, 2 napačen vnos. Tako se skripta odzove ciljano, namesto da bi razlagala besedilo.

sameqr qr list --json

Zaključek: zakaj Same-QR

CLI sameqr prinese polni obseg storitve Same-QR v terminal: QR kode, statistiko, gostujoče strani, jedilnike iz fotografij, oznake in projekte. Je vitek, s tvojim ključem ravna skrbno in govori JSON za skripte in programerske agente. In deluje v vsakem tarifu.

Začni kar zdaj: brezplačno se registriraj na sameqr.com, 20 dinamičnih QR kod je trajno brezplačnih. API, CLI in strežnik MCP so na voljo v vsakem tarifu, dokumentacija je na sameqr.com/entwickler.

Pogosta vprašanja