Same-QR
AnmeldenKostenlos starten
← Zum Blog
KI & Automatisierung2 Min. Lesezeit

CLI mit --json: Same-QR-Ausgaben in Skripten weiterverarbeiten

Bild von Unsplash

Warum JSON für Programme

Kommandozeilenprogramme antworten meist für Menschen: ein Satz, eine Tabelle. Ein Skript müsste diesen Text zerschneiden und hoffen, dass sich das Format nie ändert. JSON ist ein Textformat für strukturierte Daten, das praktisch jede Sprache lesen kann. Eine CLI mit JSON-Ausgabe liefert dieselben Informationen in fester Form.

Die Option --json

Jeder Befehl der sameqr-CLI kennt --json. Statt der Tabelle kommt dann die Antwort der API als JSON:

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

Weiterverarbeiten mit jq

In Shell-Skripten zieht das kleine Werkzeug jq einzelne Werte heraus. So listest du Name und Scans aller Codes oder merkst dir die Kennung eines neuen Codes:

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"

Fehler im Skript erkennen

Mit --json kommen auch Fehler als JSON, und zwar auf die Fehlerausgabe, damit sie die eigentlichen Daten nicht vermischen. Zusätzlich verrät der Rückgabewert die Art des Fehlers:

  • 0: alles in Ordnung.
  • 2: falsche oder fehlende Eingabe, etwa ein vergessenes --name.
  • 3: nicht angemeldet oder Schlüssel ungültig.
  • 4: keine Berechtigung, etwa ein Schlüssel „nur lesen“ oder eine Tarifgrenze.
  • 1: ein anderer Fehler der API.

Brich Schleifen beim ersten Fehler ab, statt hundertmal denselben Fehler zu produzieren, zum Beispiel mit „|| break“ hinter dem Befehl.

Beispiele für Abläufe

  • Eine Liste von Standorten wird zu Codes, die JSON-Antworten landen in einer Datei für die Druckerei.
  • Ein monatlicher Auftrag speichert „sameqr qr list --json“ als Stand für den Scan-Bericht.
  • Ein Coding-Agent ruft die CLI selbst auf und liest die JSON-Antworten, um die nächsten Schritte zu planen.

Fazit: Warum Same-QR

Die sameqr-CLI ist für Skripte gebaut: JSON auf Wunsch, Fehler sauber getrennt und mit eindeutigen Rückgabewerten, Schlüssel aus der Umgebung statt aus der Befehlszeile. So werden aus Einzelbefehlen verlässliche Abläufe, mit Same-QR in jedem Tarif.

Leg gleich los: Registriere dich kostenlos auf sameqr.com, zwei dynamische QR-Codes sind dauerhaft gratis. API, CLI und MCP-Server gibt es in jedem Tarif, die Dokumentation steht auf sameqr.com/entwickler.

Kostenlos dynamische QR-Codes erstellen
Starte mit 2 dauerhaft kostenlosen dynamischen QR-Codes. Kein Abo, keine Kreditkarte.
Jetzt gratis starten →

Häufig gestellte Fragen

Muss ich --json immer verwenden?

Nein. Am Terminal ist die normale Ausgabe angenehmer. --json ist für Skripte und Programme gedacht.

Wo landen Fehlermeldungen?

Auf der Fehlerausgabe, mit --json ebenfalls als JSON mit status, code und message. Die Daten selbst stehen auf der normalen Ausgabe.

Woran erkennt mein Skript einen fehlenden Schlüssel?

Am Rückgabewert 3. Rückgabewert 4 heißt fehlende Berechtigung.

Vormerkung

Jetzt vormerken, bevor es losgeht.

Eine E-Mail, sobald das Tool startet — mit den Preisen und dem kostenlosen Tarif. Kein Spam, jederzeit abbestellbar.

Nur bis zum StartStart in den nächsten Wochen
  • Dein kostenloser Zugang ist vorgemerkt — bezahlen kann man ohnehin noch nicht
  • 90 statt 30 Tage unbegrenzte Zieländerungen: dreifache Testphase, nur für Vorgemerkte
  • Startpreis-Garantie: dein Preis bleibt, auch wenn wir später erhöhen

Mit der Anmeldung willigst du ein, den Newsletter zu erhalten. Die Einwilligung kannst du jederzeit über den Abmeldelink in jeder E-Mail widerrufen.

Weiterlesen