Same-QR
Zaloguj sięZacznij za darmo
Zacznij za darmo
← Wróć do bloga
AI i automatyzacja2 min czytania

CLI z --json: przetwarzanie wyników Same-QR w skryptach

Zdjęcie z Unsplash

Dlaczego JSON dla programów

Programy wiersza poleceń odpowiadają zwykle ludziom: zdaniem albo tabelą. Skrypt musiałby ciąć taki tekst na kawałki i mieć nadzieję, że format się nie zmieni. JSON to format tekstowy dla danych uporządkowanych, który odczyta praktycznie każdy język. CLI z wyjściem JSON podaje te same informacje w stałej postaci.

Opcja --json

Każde polecenie sameqr-CLI zna --json. Zamiast tabeli dostajesz wtedy odpowiedź API w formacie JSON:

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

Dalsze przetwarzanie z jq

W skryptach powłoki małe narzędzie jq wyciąga pojedyncze wartości. W ten sposób wypiszesz nazwę i liczbę skanów wszystkich kodów QR albo zapamiętasz identyfikator nowego kodu QR:

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"

Rozpoznawanie błędów w skrypcie

Z --json błędy też przychodzą jako JSON, i to na wyjściu błędów, żeby nie mieszały się z właściwymi danymi. Dodatkowo kod zakończenia zdradza rodzaj błędu:

  • 0: wszystko w porządku.
  • 2: błędne lub brakujące dane wejściowe, na przykład zapomniane --name.
  • 3: brak logowania lub nieprawidłowy klucz.
  • 4: brak uprawnień, na przykład klucz „tylko odczyt” albo limit planu.
  • 1: inny błąd API.

Przerywaj pętle przy pierwszym błędzie, zamiast sto razy powtarzać ten sam błąd, na przykład przez „|| break” za poleceniem.

Przykłady procesów

  • Lista lokalizacji zamienia się w kody QR, a odpowiedzi JSON trafiają do pliku dla drukarni.
  • Miesięczne zadanie zapisuje „sameqr qr list --json” jako stan do raportu skanów.
  • Agent programistyczny sam wywołuje CLI i czyta odpowiedzi JSON, żeby zaplanować kolejne kroki.

Podsumowanie: dlaczego Same-QR

sameqr-CLI jest zbudowane dla skryptów: JSON na życzenie, błędy czysto oddzielone i z jednoznacznymi kodami zakończenia, klucz ze środowiska zamiast z wiersza poleceń. Z pojedynczych poleceń robią się niezawodne procesy, z Same-QR w każdym planie.

Zacznij od razu: zarejestruj się za darmo na sameqr.com, 20 dynamicznych kodów QR jest na stałe bezpłatne. API, CLI i serwer MCP są w każdym planie, dokumentacja jest na sameqr.com/entwickler.

Twórz dynamiczne kody QR za darmo
Zacznij od 20 dynamicznych kodów QR, które są darmowe na zawsze. Bez subskrypcji, bez karty kredytowej.
Zacznij za darmo →

Najczęściej zadawane pytania

Czy muszę zawsze używać --json?

Nie. W terminalu zwykłe wyjście jest wygodniejsze. --json jest przeznaczone dla skryptów i programów.

Gdzie trafiają komunikaty o błędach?

Na wyjście błędów, z --json również jako JSON z polami status, code i message. Same dane trafiają na zwykłe wyjście.

Po czym mój skrypt pozna brak klucza?

Po kodzie zakończenia 3. Kod 4 oznacza brak uprawnień.

Newsletter

Nowe artykuły prosto na Twoją skrzynkę

Wskazówki o dynamicznych kodach QR, nowości, bez spamu. Wypisać się można w każdej chwili.

Zapisując się, wyrażasz zgodę na otrzymywanie newslettera. Zgodę możesz w każdej chwili wycofać za pomocą linku do wypisania się w każdej wiadomości.

Czytaj dalej