QR-Code per riga di comando: installare e utilizzare la CLI sameqr

Perché la riga di comando

Una CLI (Command Line Interface) è un programma che tu gestisci tramite comandi di testo nel terminale. Un comando può essere ripetuto, scritto in uno script, concatenato con altri strumenti ed eseguito da un agente di coding. La CLI sameqr porta Same-QR esattamente lì. Non ha altre dipendenze e richiede solo Node.js dalla versione 18 in poi.

Passo 1: Installazione

La CLI si installa tramite npm, il gestore di pacchetti di Node.js:

npm install -g sameqr
sameqr --version

Passo 2: Creare la chiave API

Nella dashboard, sotto Account, trova la sezione «Accesso per CLI, script e agenti». Crea lì una chiave. Per iniziare basta «lettura + scrittura»: creare, cambiare nomi e testi. Chi vuole anche cambiare le destinazioni di codici esistenti, mettere pagine offline o eliminare sceglie «completo». La chiave inizia con sqr_live_ e viene mostrata una sola volta. La salvi subito nel tuo gestore di password.

Passo 3: Accesso

La chiave non viene mai passata come argomento, altrimenti apparirebbe nella cronologia della shell. "sameqr login" la chiede in modo nascosto, la verifica e la salva in sola lettura per te in ~/.config/sameqr/config.json. In alternativa, tu imposti la variabile d'ambiente SAMEQR_API_KEY, che ha sempre la precedenza.

sameqr login
sameqr whoami

"sameqr whoami" mostra il tuo account, il piano e quanti codici tu puoi creare.

Passo 4: Creare il primo codice

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>

Con --slug si stabilisce un proprio link breve durante la creazione, con --label si aggiungono etichette. Le tue identificazioni vengono mostrate da “sameqr labels list”. Modificare la destinazione, rimuovere offline ed eliminare richiedono una chiave “voll”. La CLI chiede quindi nel terminale, negli script senza terminale si procede solo con --yes esplicito. Attraverso l’API sono possibili al massimo 10 tali modifiche all’ora e 30 al giorno.

Passo 5: Pagine ospiti e menu

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“ restituisce l'indirizzo della nuova pagina, nell'esempio menu/gasthof-zum-loewen. Questo è necessario per i comandi successivi. La pagina viene creata come bozza. „karte import“ legge le foto tramite IA e collega i gruppi riconosciuti alla pagina, senza sovrascrivere nulla. Si prega di esaminare la bozza prima di pubblicarla. Per la pubblicazione, i dati degli operatori devono essere compilati. L'ultimo comando genera un codice che punta direttamente alla pagina. Altri modelli: preisliste, zeiten, links, aktion, weingut, etikett e kontakt.

Passo 6: Negli script con --json

Se si aggiunge --json a un comando, la risposta viene fornita in formato JSON. Gli errori vengono anch'essi restituiti come JSON sull'output degli errori, e il valore di ritorno indica il tipo: 3 significa non autenticato, 4 permessi mancanti, 2 un input errato. In questo modo, uno script può reagire in modo mirato invece di interpretare il testo.

sameqr qr list --json

Conclusione: perché Same-QR

La CLI sameqr offre la piena gamma di funzionalità di Same-QR nel terminale: codici, statistiche, pagine ospiti, menu da foto, etichette e progetti. È leggera, gestisce con cura la tua chiave e utilizza JSON per script e agenti di coding. E funziona in ogni tariffa.

Inizi subito: registrati gratuitamente su sameqr.com, due codici QR dinamici sono gratuiti per sempre. API, CLI e server MCP sono inclusi in ogni piano, la documentazione è su sameqr.com/entwickler.

Domande frequenti