CLI s opcijom --json: obrada Same-QR izlaza u skriptama

Zašto JSON za programe

Programi za komandnu liniju najčešće odgovaraju ljudima: jednom rečenicom, jednom tabelom. Skripta bi taj tekst morala rezati na dijelove i nadati se da se format nikada neće promijeniti. JSON je tekstualni format za strukturirane podatke koji može pročitati gotovo svaki programski jezik. CLI s JSON izlazom daje iste informacije u čvrstom obliku.

Opcija --json

Svaka naredba sameqr CLI-ja poznaje --json. Umjesto tabele dobiješ odgovor API-ja kao JSON:

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

Obrada pomoću jq

U shell skriptama mali alat jq izvlači pojedinačne vrijednosti. Tako možeš ispisati naziv i broj skeniranja svih QR kodova ili zapamtiti identifikator novog QR koda:

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"

Prepoznavanje grešaka u skripti

Uz --json i greške stižu kao JSON, i to na izlaz za greške, kako se ne bi miješale sa stvarnim podacima. Osim toga, povratna vrijednost otkriva vrstu greške:

• 0: sve je u redu.
• 2: pogrešan ili nedostajući unos, na primjer zaboravljen --name.
• 3: nisi prijavljen ili je ključ nevažeći.
• 4: nema ovlaštenja, na primjer ključ „samo čitanje“ ili granica tarife.
• 1: neka druga greška API-ja.

Prekini petlje pri prvoj grešci umjesto da stotinu puta proizvedeš istu grešku, na primjer s „|| break“ iza naredbe.

Primjeri tokova rada

• Lista lokacija postaje QR kodovi, a JSON odgovori završavaju u datoteci za štampariju.
• Mjesečni zadatak sprema „sameqr qr list --json“ kao stanje za izvještaj o skeniranjima.
• Coding agent sam poziva CLI i čita JSON odgovore kako bi isplanirao sljedeće korake.

Zaključak: zašto Same-QR

sameqr CLI je napravljen za skripte: JSON na zahtjev, greške čisto odvojene i s jednoznačnim povratnim vrijednostima, ključ iz okruženja umjesto iz komandne linije. Tako od pojedinačnih naredbi nastaju pouzdani tokovi rada, uz Same-QR u svakoj tarifi.

Počni odmah: registruj se besplatno na sameqr.com, 20 dinamičkih QR kodova je trajno besplatno. API, CLI i MCP server dostupni su u svakoj tarifi, a dokumentacija je na sameqr.com/entwickler.

Često postavljana pitanja