Same-QR
PrijavaKreni besplatno
Kreni besplatno
← Nazad na blog
VI i automatizacija2 min čitanja

CLI sa --json: dalja obrada izlaza servisa Same-QR u skriptama

Slika sa Unsplasha

Zašto JSON za programe

Programi za komandnu liniju najčešće odgovaraju za ljude: jedna rečenica, jedna tabela. Skripta bi morala da iseče taj tekst i da se nada da se format nikada neće promeniti. JSON je tekstualni format za strukturirane podatke koji može da pročita praktično svaki jezik. CLI sa JSON izlazom daje iste informacije u čvrstom obliku.

Opcija --json

Svaka komanda sameqr CLI-ja poznaje --json. Umesto tabele dobijaš 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

Dalja obrada sa jq-om

U shell skriptama mali alat jq izvlači pojedinačne vrednosti. Tako ispisuješ ime i broj skeniranja svih QR kodova ili pamtiš oznaku 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

Sa --json i greške stižu kao JSON, i to na izlaz za greške, da se ne mešaju sa pravim podacima. Pored toga, povratna vrednost otkriva vrstu greške:

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

Prekini petlje pri prvoj grešci umesto da sto puta napraviš istu grešku, na primer sa „|| break“ iza komande.

Primeri postupaka

  • Lista lokacija postaje QR kodovi, a JSON odgovori završavaju u datoteci za štampariju.
  • Mesečni zadatak čuva „sameqr qr list --json“ kao stanje za izveštaj o skeniranju.
  • Agent za programiranje sam poziva CLI i čita JSON odgovore da bi planirao sledeće korake.

Zaključak: Zašto Same-QR

sameqr CLI je napravljen za skripte: JSON na zahtev, greške uredno odvojene i sa jasnim povratnim vrednostima, ključ iz okruženja umesto iz komandne linije. Tako od pojedinačnih komandi nastaju pouzdani postupci, sa servisom Same-QR u svakom paketu.

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 svakom paketu, a dokumentacija se nalazi na sameqr.com/entwickler.

Napravi dinamične QR kodove besplatno
Kreni sa 20 dinamičnih QR kodova koji su zauvek besplatni. Bez pretplate, bez kreditne kartice.
Kreni besplatno →

Često postavljana pitanja

Moram li uvek da koristim --json?

Ne. U terminalu je običan izlaz prijatniji. --json je namenjen skriptama i programima.

Gde završavaju poruke o greškama?

Na izlazu za greške, sa --json takođe kao JSON sa poljima status, code i message. Sami podaci su na običnom izlazu.

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

Po povratnoj vrednosti 3. Povratna vrednost 4 znači nedostajuću dozvolu.

Bilten

Novi članci direktno u tvoj inboks

Saveti o dinamičnim QR kodovima, novosti, bez spama. Odjava u bilo kom trenutku.

Prijavom pristaješ da primaš bilten. Saglasnost možeš da povučeš u bilo kom trenutku preko linka za odjavu u svakoj poruci.

Nastavi sa čitanjem