Cod QR din linia de comandă: instalează și folosește CLI-ul sameqr

De ce linia de comandă

Un CLI (Command Line Interface) este un program pe care îl folosești prin comenzi text în terminal. O comandă poate fi repetată, scrisă într-un script, legată de alte instrumente și executată de un agent de programare. CLI-ul sameqr aduce Same-QR exact acolo. Nu are alte dependențe și are nevoie doar de Node.js începând cu versiunea 18.

Pasul 1: Instalarea

CLI-ul vine prin npm, managerul de pachete al Node.js:

npm install -g sameqr
sameqr --version

Pasul 2: Creează o cheie API

În dashboard, la Cont, găsești secțiunea „Acces pentru CLI, scripturi și agenți”. Creează acolo o cheie. Pentru început este suficient „citire + scriere”: creezi coduri, schimbi nume și texte. Cine vrea să schimbe și destinațiile codurilor QR existente, să scoată pagini offline sau să șteargă alege „complet”. Cheia începe cu sqr_live_ și este afișată o singură dată. Salveaz-o imediat în managerul tău de parole.

Pasul 3: Autentificarea

Cheia nu se transmite niciodată ca argument, altfel ar rămâne în istoricul shell-ului. „sameqr login” o cere în mod ascuns, o verifică și o salvează, lizibilă doar pentru tine, în ~/.config/sameqr/config.json. Alternativ, setezi variabila de mediu SAMEQR_API_KEY, care are mereu prioritate.

sameqr login
sameqr whoami

„sameqr whoami” îți arată contul, tariful și câte coduri QR poți crea.

Pasul 4: Creează primul cod QR

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>

Cu --slug stabilești la creare un link scurt propriu, cu --label atașezi etichete. Identificatorii lor îi arată „sameqr labels list”. Schimbarea destinației, scoaterea offline și ștergerea necesită o cheie „complet”. CLI-ul te întreabă atunci în terminal, iar în scripturi fără terminal merge doar cu --yes expres. Prin API sunt posibile cel mult 10 astfel de modificări pe oră și 30 pe zi.

Pasul 5: Pagini pentru oaspeți și meniuri

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” afișează adresa noii pagini, în exemplu menu/gasthof-zum-loewen. Ai nevoie de ea pentru comenzile următoare. Pagina apare ca ciornă. „karte import” citește fotografiile cu ajutorul AI și atașează grupele recunoscute la pagină, fără a suprascrie nimic. Parcurge ciorna înainte de a publica. Pentru publicare trebuie completate datele operatorului. Ultima comandă creează un cod QR care indică direct spre pagină. Alte șabloane: preisliste, zeiten, links, aktion, weingut, etikett și kontakt.

Pasul 6: În scripturi, cu --json

Dacă adaugi --json la o comandă, răspunsul vine în format JSON. Erorile ajung atunci tot ca JSON pe ieșirea de erori, iar codul de retur arată tipul lor: 3 înseamnă neautentificat, 4 drepturi lipsă, 2 o introducere greșită. Astfel, un script reacționează țintit, în loc să interpreteze text.

sameqr qr list --json

Concluzie: de ce Same-QR

CLI-ul sameqr aduce în terminal întreaga gamă de funcții Same-QR: coduri QR, statistici, pagini pentru oaspeți, meniuri din fotografii, etichete și proiecte. Este suplu, îți tratează cu grijă cheia și vorbește JSON pentru scripturi și agenți de programare. Și funcționează în orice tarif.

Începe chiar acum: înregistrează-te gratuit pe sameqr.com, 20 de coduri QR dinamice sunt gratuite permanent. API, CLI și server MCP există în fiecare tarif, iar documentația se află pe sameqr.com/entwickler.

Întrebări frecvente