CLI --json kapcsolóval: a Same-QR kimenetek feldolgozása szkriptekben

Miért JSON a programoknak

A parancssori programok általában embereknek válaszolnak: egy mondattal, egy táblázattal. Egy szkriptnek ezt a szöveget szét kellene vágnia, és abban bíznia, hogy a formátum sosem változik. A JSON strukturált adatokra való szövegformátum, amelyet gyakorlatilag minden nyelv olvas. A JSON-kimenetes CLI ugyanazokat az információkat adja, de rögzített formában.

A --json kapcsoló

A sameqr CLI minden parancsa ismeri a --json kapcsolót. A táblázat helyett ilyenkor az API válasza érkezik JSON-ként:

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

Feldolgozás jq-val

Shell-szkriptekben a kis jq eszköz kiemeli az egyes értékeket. Így listázhatod az összes QR-kód nevét és szkennelésszámát, vagy megjegyezheted egy új QR-kód azonosítóját:

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"

Hibák felismerése a szkriptben

A --json kapcsolóval a hibák is JSON-ként érkeznek, mégpedig a hibakimenetre, hogy ne keveredjenek a tényleges adatokkal. Emellett a visszatérési érték elárulja a hiba fajtáját:

• 0: minden rendben.
• 2: hibás vagy hiányzó bemenet, például egy elfelejtett --name.
• 3: nem vagy bejelentkezve, vagy a kulcs érvénytelen.
• 4: nincs jogosultság, például „csak olvasható” kulcs vagy csomaghatár miatt.
• 1: az API más hibája.

A ciklusokat az első hibánál szakítsd meg, ahelyett hogy százszor ugyanazt a hibát állítanád elő, például a parancs mögé írt „|| break” segítségével.

Példák folyamatokra

• Helyszínek listájából QR-kódok lesznek, a JSON-válaszok egy fájlba kerülnek a nyomda számára.
• Egy havi feladat elmenti a „sameqr qr list --json” kimenetét a szkennelési jelentés állásaként.
• Egy kódoló ügynök maga hívja a CLI-t, és a JSON-válaszokat olvasva tervezi a következő lépéseket.

Összegzés: miért a Same-QR

A sameqr CLI szkriptekre épült: kérésre JSON, tisztán elkülönített hibák egyértelmű visszatérési értékekkel, kulcs a környezetből a parancssor helyett. Így az egyes parancsokból megbízható folyamatok lesznek, a Same-QR-rel minden csomagban.

Kezdj bele rögtön: regisztrálj ingyen a sameqr.com oldalon, 20 dinamikus QR-kód tartósan ingyenes. Az API, a CLI és az MCP-szerver minden csomagban elérhető, a dokumentáció a sameqr.com/entwickler címen található.

Gyakran ismételt kérdések