CLI con --json: elaborare gli output di Same-QR negli script

Perché JSON per i programmi

I programmi da riga di comando rispondono solitamente per gli esseri umani: una frase, una tabella. Uno script dovrebbe tagliare questo testo e sperare che il formato non cambi mai. JSON è un formato di testo per dati strutturati, che quasi ogni lingua può leggere. Una CLI con output JSON fornisce le stesse informazioni in forma fissa.

L'opzione --json

Ogni comando della CLI sameqr conosce --json. Invece della tabella, la risposta dell'API viene fornita come JSON:

sameqr qr list --json
sameqr qr create --name "Plakat Nord" --url https://example.com/aktion --json
sameqr seite list --json

Elaborazione con jq

Negli script shell, il piccolo strumento jq estrae i singoli valori. In questo modo, il tuo programma elenca il nome e gli scan di tutti i codici o memorizza l'identificativo di un nuovo codice:

sameqr qr list --json | jq -r '.codes[] | "\(.name);\(.scanCount)"'

id=$(sameqr qr create --name "Plakat Süd" --url https://example.com/aktion --json | jq -r .id)
sameqr qr stats "$id"

Riconoscere gli errori nello script

Con --json, anche gli errori arrivano come JSON, e precisamente sull'output di errore, in modo da non mescolare i dati effettivi. Inoltre, il valore di ritorno indica il tipo di errore:

• 0: tutto a posto.
• 2: input errato o mancante, ad esempio un --name dimenticato.
• 3: non autenticati o chiave non valida.
• 4: nessuna autorizzazione, ad esempio una chiave "solo lettura" o un limite di tariffa.
• 1: un altro errore dell'API.

Interrompi i cicli al primo errore, invece di produrre cento volte lo stesso errore, ad esempio con "|| break" dopo il comando.

Esempi di flussi di lavoro

• Un elenco di posizioni viene convertito in codici; le risposte JSON finiscono in un file per la tipografia.
• Un incarico mensile salva "sameqr qr list --json" come stato per il rapporto di scansione.
• Un agente di codifica richiama la CLI stessa e legge le risposte JSON per pianificare i prossimi passaggi.

Conclusione: perché Same-QR

La CLI sameqr è progettata per gli script: JSON su richiesta, errori separati in modo pulito e con valori di ritorno univoci, chiavi dall'ambiente invece che dalla riga di comando. In questo modo, da comandi singoli si ottengono flussi di lavoro affidabili, con Same-QR in ogni tariffa.

Inizi subito: ti registri 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