Same-QR
Přihlásit seZačít zdarma
Začít zdarma
← Zpět na blog
AI a automatizace2 min čtení

CLI s --json: zpracování výstupů Same-QR ve skriptech

Obrázek z Unsplash

Proč JSON pro programy

Programy pro příkazový řádek většinou odpovídají lidem: věta, tabulka. Skript by musel tento text rozsekat a doufat, že se formát nikdy nezmění. JSON je textový formát pro strukturovaná data, který přečte prakticky každý jazyk. CLI s výstupem JSON podává stejné informace v pevné podobě.

Volba --json

Každý příkaz sameqr CLI zná --json. Místo tabulky pak přijde odpověď API ve formátu JSON:

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

Další zpracování pomocí jq

V shellových skriptech vytáhne jednotlivé hodnoty malý nástroj jq. Takto vypíšeš název a počet skenů všech QR kódů nebo si zapamatuješ identifikátor nového QR kódu:

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"

Rozpoznání chyb ve skriptu

S --json přicházejí i chyby jako JSON, a to na chybový výstup, aby se nepromíchaly s vlastními daty. Druh chyby navíc prozradí návratová hodnota:

  • 0: vše v pořádku.
  • 2: chybný nebo chybějící vstup, například zapomenuté --name.
  • 3: nejsi přihlášený nebo je klíč neplatný.
  • 4: chybí oprávnění, například klíč „jen čtení“ nebo limit tarifu.
  • 1: jiná chyba API.

Přerušuj smyčky při první chybě, místo abys stokrát vyráběl tutéž chybu, například pomocí „|| break“ za příkazem.

Příklady postupů

  • Seznam provozoven se změní na QR kódy, odpovědi JSON skončí v souboru pro tiskárnu.
  • Měsíční úloha uloží „sameqr qr list --json“ jako stav pro report skenů.
  • Coding agent sám volá CLI a čte odpovědi JSON, aby naplánoval další kroky.

Závěr: proč Same-QR

sameqr CLI je postavené pro skripty: JSON na požádání, chyby čistě odděleně a s jednoznačnými návratovými hodnotami, klíč z prostředí místo z příkazového řádku. Z jednotlivých příkazů tak vznikají spolehlivé postupy, se Same-QR v každém tarifu.

Začni hned: zaregistruj se zdarma na sameqr.com, 20 dynamických QR kódů je trvale zdarma. API, CLI a MCP server najdeš v každém tarifu, dokumentace je na sameqr.com/entwickler.

Vytvoř dynamické QR kódy zdarma
Začni s 20 dynamickými QR kódy, které jsou zdarma navždy. Bez předplatného, bez platební karty.
Začít zdarma →

Často kladené otázky

Musím vždy používat --json?

Ne. V terminálu je příjemnější běžný výstup. --json je určeno pro skripty a programy.

Kam se dostanou chybová hlášení?

Na chybový výstup, s --json také jako JSON s položkami status, code a message. Samotná data jsou na běžném výstupu.

Podle čeho pozná můj skript chybějící klíč?

Podle návratové hodnoty 3. Návratová hodnota 4 znamená chybějící oprávnění.

Newsletter

Nové články rovnou do tvé schránky

Tipy k dynamickým QR kódům, novinky, žádný spam. Odhlásit se můžeš kdykoli.

Přihlášením souhlasíš se zasíláním newsletteru. Souhlas můžeš kdykoli odvolat pomocí odkazu pro odhlášení v každém e-mailu.

Čti dál