QR-kód parancssorból: a sameqr CLI telepítése és használata

Miért a parancssor

A CLI (Command Line Interface) olyan program, amelyet szöveges parancsokkal vezérelsz a terminálban. Egy parancs megismételhető, beírható egy szkriptbe, összekapcsolható más eszközökkel, és egy programozó ágens is végre tudja hajtani. A sameqr CLI pontosan ide hozza el a Same-QR-t. Nincsenek további függőségei, csak a Node.js 18-as vagy újabb verziójára van szüksége.

1. lépés: Telepítés

A CLI az npm-en keresztül érkezik, ami a Node.js csomagkezelője:

npm install -g sameqr
sameqr --version

2. lépés: API-kulcs létrehozása

Az irányítópulton a Fiók menüben megtalálod a „Hozzáférés CLI-hez, szkriptekhez és ágensekhez” szakaszt. Hozz létre ott egy kulcsot. Az elejére az „olvasás + írás” elég: létrehozás, nevek és szövegek módosítása. Aki meglévő QR-kódok célját is módosítani, oldalakat offline állapotba tenni vagy törölni szeretne, az a „teljes” jogosultságot válassza. A kulcs sqr_live_ előtaggal kezdődik, és csak egyszer jelenik meg. Mentsd el azonnal a jelszókezelődben.

3. lépés: Bejelentkezés

A kulcsot soha nem adod meg argumentumként, különben benne maradna a shell előzményeiben. A „sameqr login” rejtve kéri be, ellenőrzi, és csak általad olvasható módon menti a ~/.config/sameqr/config.json fájlba. Másik lehetőség, hogy beállítod a SAMEQR_API_KEY környezeti változót, amely mindig elsőbbséget élvez.

sameqr login
sameqr whoami

A „sameqr whoami” megmutatja a fiókodat, a csomagodat, és hogy hány QR-kódot hozhatsz még létre.

4. lépés: Az első QR-kód létrehozása

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>

A --slug kapcsolóval már létrehozáskor megadhatsz saját rövid linket, a --label kapcsolóval címkéket rendelhetsz hozzá. Az azonosítóikat a „sameqr labels list” mutatja. A cél módosításához, az offline állapothoz és a törléshez „teljes” kulcs kell. A CLI ilyenkor megerősítést kér a terminálban, terminál nélküli szkriptekben csak a kifejezett --yes kapcsolóval működik. Az API-n keresztül legfeljebb 10 ilyen módosítás lehetséges óránként, 30 pedig naponta.

5. lépés: Vendégoldalak és étlapok

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

A „seite create” kiírja az új oldal címét, a példában ez menu/gasthof-zum-loewen. Erre szükséged lesz a következő parancsokhoz. Az oldal vázlatként jön létre. A „karte import” MI-vel beolvassa a fotókat, és a felismert csoportokat hozzáfűzi az oldalhoz, anélkül hogy bármit felülírna. Nézd át a vázlatot, mielőtt közzéteszed. A közzétételhez ki kell tölteni az üzemeltetői adatokat. Az utolsó parancs létrehoz egy QR-kódot, amely közvetlenül az oldalra mutat. További sablonok: preisliste, zeiten, links, aktion, weingut, etikett és kontakt.

6. lépés: Szkriptekben a --json kapcsolóval

Ha egy parancs után odaírod a --json kapcsolót, a válasz JSON formátumban érkezik. A hibák is JSON-ként kerülnek a hibakimenetre, a visszatérési érték pedig elárulja a hiba fajtáját: a 3 azt jelenti, hogy nem vagy bejelentkezve, a 4 hiányzó jogosultságot, a 2 hibás bevitelt. Így a szkript célzottan reagálhat, ahelyett hogy szöveget kellene értelmeznie.

sameqr qr list --json

Összegzés: miért a Same-QR

A sameqr CLI a Same-QR teljes funkcióválasztékát elhozza a terminálba: QR-kódok, statisztika, vendégoldalak, fotókból készülő étlapok, címkék és projektek. Karcsú, gondosan bánik a kulcsoddal, és JSON-t beszél a szkriptek és a programozó ágensek számára. És minden csomagban működik.

Vágj bele rögtön: regisztrálj ingyen a sameqr.com oldalon, 20 dinamikus QR-kód tartósan ingyenes. Az API, a CLI és az MCP-szerver minden csomagban elérhető, a dokumentáció a sameqr.com/entwickler címen található.

Gyakran ismételt kérdések