Same-QR
PrijavaPočni besplatno
Počni besplatno
← Natrag na blog
UI i automatizacija2 min čitanja

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

Slika s Unsplasha

Zašto JSON za programe

Programi naredbenog retka obično odgovaraju ljudima: jednom rečenicom ili tablicom. Skripta bi morala razrezati taj tekst i nadati se da se format nikad neće promijeniti. JSON je tekstni 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 tablice dobiješ odgovor API-ja u JSON-u:

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

Daljnja obrada s jq

U shell skriptama mali alat jq izvlači pojedine 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 pogrešaka u skripti

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

  • 0: sve je u redu.
  • 2: pogrešan ili nedostajući unos, primjerice zaboravljen --name.
  • 3: nisi prijavljen ili je ključ neispravan.
  • 4: nema ovlasti, primjerice ključ „samo čitanje“ ili dosegnuto ograničenje paketa.
  • 1: neka druga pogreška API-ja.

Prekini petlje kod prve pogreške umjesto da stotinu puta proizvodiš istu pogrešku, na primjer s „|| break“ iza naredbe.

Primjeri tijekova rada

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

Zaključak: zašto Same-QR

sameqr CLI izgrađen je za skripte: JSON na zahtjev, pogreške uredno odvojene i s jasnim povratnim vrijednostima, ključ iz okruženja umjesto iz naredbenog retka. Tako od pojedinačnih naredbi nastaju pouzdani tijekovi rada, uz Same-QR u svakom paketu.

Kreni odmah: registriraj se besplatno na sameqr.com, 20 dinamičkih QR kodova trajno je besplatno. API, CLI i MCP poslužitelj dostupni su u svakom paketu, dokumentacija je na sameqr.com/entwickler.

Izradi dinamične QR kodove besplatno
Počni s 20 dinamičnih QR kodova koji su zauvijek besplatni. Bez pretplate, bez kreditne kartice.
Počni besplatno →

Često postavljana pitanja

Moram li uvijek koristiti --json?

Ne. U terminalu je uobičajeni izlaz ugodniji. --json je namijenjen skriptama i programima.

Gdje završavaju poruke o pogreškama?

Na izlazu za pogreške, s opcijom --json također kao JSON sa status, code i message. Sami podaci nalaze se na uobičajenom izlazu.

Po čemu moja skripta prepoznaje nedostajući ključ?

Po povratnoj vrijednosti 3. Povratna vrijednost 4 znači nedostajuću ovlast.

Newsletter

Novi članci izravno u tvoj inbox

Savjeti o dinamičnim QR kodovima, novosti, bez spama. Odjava u svakom trenutku.

Prijavom pristaješ na primanje newslettera. Privolu možeš povući u bilo kojem trenutku putem poveznice za odjavu u svakoj e-poruci.

Nastavi čitati