Same-QR
AutentificareÎncepe gratuit
Începe gratuit
← Înapoi la blog
IA și automatizare2 min de citit

CLI cu --json: prelucrează ieșirile Same-QR în scripturi

Imagine de pe Unsplash

De ce JSON pentru programe

Programele din linia de comandă răspund de obicei pentru oameni: o propoziție, un tabel. Un script ar trebui să taie acest text în bucăți și să spere că formatul nu se schimbă niciodată. JSON este un format text pentru date structurate, pe care îl poate citi practic orice limbaj. Un CLI cu ieșire JSON oferă aceleași informații într-o formă fixă.

Opțiunea --json

Fiecare comandă a CLI-ului sameqr cunoaște --json. În locul tabelului primești atunci răspunsul API-ului în format JSON:

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

Prelucrare cu jq

În scripturile shell, micul instrument jq extrage valori individuale. Așa listezi numele și scanările tuturor codurilor QR sau îți notezi identificatorul unui cod QR nou:

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"

Recunoaște erorile în script

Cu --json, și erorile vin în format JSON, și anume pe ieșirea de erori, ca să nu se amestece cu datele propriu-zise. În plus, valoarea returnată îți arată felul erorii:

  • 0: totul în regulă.
  • 2: date introduse greșit sau lipsă, de exemplu un --name uitat.
  • 3: neautentificat sau cheie nevalidă.
  • 4: fără permisiune, de exemplu o cheie „doar citire” sau o limită a tarifului.
  • 1: altă eroare a API-ului.

Oprește buclele la prima eroare, în loc să produci de o sută de ori aceeași eroare, de exemplu cu „|| break” după comandă.

Exemple de fluxuri

  • O listă de locații devine coduri QR, iar răspunsurile JSON ajung într-un fișier pentru tipografie.
  • O sarcină lunară salvează „sameqr qr list --json” ca situație pentru raportul de scanări.
  • Un agent de programare apelează singur CLI-ul și citește răspunsurile JSON pentru a-și planifica pașii următori.

Concluzie: de ce Same-QR

CLI-ul sameqr este construit pentru scripturi: JSON la cerere, erori separate curat și cu valori returnate clare, cheie din mediu în loc de linia de comandă. Așa, din comenzi izolate se fac fluxuri de încredere, cu Same-QR î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 orice tarif, iar documentația se află pe sameqr.com/entwickler.

Creează coduri QR dinamice gratuit
Începe cu 20 de coduri QR dinamice gratuite pentru totdeauna. Fără abonament, fără card bancar.
Începe gratuit acum →

Întrebări frecvente

Trebuie să folosesc mereu --json?

Nu. În terminal, ieșirea obișnuită e mai plăcută. --json este gândit pentru scripturi și programe.

Unde ajung mesajele de eroare?

Pe ieșirea de erori, cu --json tot în format JSON, cu status, code și message. Datele propriu-zise se află pe ieșirea normală.

Cum recunoaște scriptul meu o cheie lipsă?

După valoarea returnată 3. Valoarea returnată 4 înseamnă lipsa permisiunii.

Newsletter

Articole noi direct în inbox

Sfaturi despre codurile QR dinamice, noutăți, fără spam. Te poți dezabona oricând.

Abonându-te, ești de acord să primești newsletterul. Îți poți retrage acordul oricând prin linkul de dezabonare din fiecare e-mail.

Citește mai departe