Same-QR
PrijavaZačni brezplačno
Začni brezplačno
← Nazaj na blog
UI in avtomatizacija2 min branja

CLI z --json: izpise Same-QR obdelaj naprej v skriptah

Slika z Unsplasha

Zakaj JSON za programe

Programi za ukazno vrstico večinoma odgovarjajo ljudem: stavek, tabela. Skripta bi morala to besedilo razrezati in upati, da se oblika nikoli ne spremeni. JSON je besedilni zapis za strukturirane podatke, ki ga zna prebrati praktično vsak jezik. CLI z izpisom JSON vrne iste informacije v stalni obliki.

Možnost --json

Vsak ukaz CLI sameqr pozna --json. Namesto tabele dobiš odgovor API-ja kot JSON:

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

Nadaljnja obdelava z jq

V lupinskih skriptah majhno orodje jq izvleče posamezne vrednosti. Tako izpišeš ime in število skenov vseh QR kod ali si zapomniš identifikator nove QR kode:

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 napak v skripti

Z --json tudi napake pridejo kot JSON, in sicer na izhod za napake, da se ne mešajo z dejanskimi podatki. Poleg tega izhodna koda izda vrsto napake:

  • 0: vse v redu.
  • 2: napačen ali manjkajoč vnos, na primer pozabljen --name.
  • 3: nisi prijavljen ali ključ ni veljaven.
  • 4: ni pooblastila, na primer ključ „samo branje“ ali meja paketa.
  • 1: druga napaka API-ja.

Zanke prekini ob prvi napaki, namesto da stokrat ustvariš isto napako, na primer z „|| break“ za ukazom.

Primeri postopkov

  • Seznam lokacij postane seznam QR kod, odgovori JSON pristanejo v datoteki za tiskarno.
  • Mesečno opravilo shrani „sameqr qr list --json“ kot stanje za poročilo o skenih.
  • Kodirni agent sam pokliče CLI in prebere odgovore JSON, da načrtuje naslednje korake.

Zaključek: zakaj Same-QR

CLI sameqr je zgrajen za skripte: JSON na željo, napake čisto ločene in z nedvoumnimi izhodnimi kodami, ključ iz okolja namesto iz ukazne vrstice. Tako iz posameznih ukazov nastanejo zanesljivi postopki, s Same-QR v vsakem paketu.

Začni kar zdaj: brezplačno se registriraj na sameqr.com, 20 dinamičnih QR kod je trajno brezplačnih. API, CLI in strežnik MCP so na voljo v vsakem paketu, dokumentacija je na sameqr.com/entwickler.

Ustvari dinamične QR kode brezplačno
Začni z 20 dinamičnimi QR kodami, ki so brezplačne za vedno. Brez naročnine, brez kreditne kartice.
Začni brezplačno →

Pogosta vprašanja

Ali moram vedno uporabljati --json?

Ne. V terminalu je običajni izpis prijetnejši. --json je namenjen skriptam in programom.

Kam pristanejo sporočila o napakah?

Na izhod za napake, z --json prav tako kot JSON s poljema status, code in message. Podatki sami so na običajnem izhodu.

Po čem moja skripta prepozna manjkajoči ključ?

Po izhodni kodi 3. Izhodna koda 4 pomeni manjkajoče pooblastilo.

Novičnik

Novi članki neposredno v tvoj nabiralnik

Nasveti o dinamičnih QR kodah, novosti, brez neželene pošte. Odjava je mogoča kadar koli.

S prijavo soglašaš s prejemanjem novičnika. Soglasje lahko kadar koli prekličeš s povezavo za odjavo v vsakem e-poštnem sporočilu.

Beri naprej