--json ile CLI: Same-QR çıktılarını betiklerde işle

Programlar için neden JSON

Komut satırı programları çoğunlukla insanlara yanıt verir: bir cümle, bir tablo. Bir betik bu metni parçalamak ve biçimin hiç değişmeyeceğine güvenmek zorunda kalır. JSON, yapılandırılmış veriler için hemen her dilin okuyabildiği bir metin biçimidir. JSON çıktılı bir CLI aynı bilgiyi sabit bir biçimde verir.

--json seçeneği

sameqr CLI'nın her komutu --json seçeneğini tanır. Tablo yerine API'nin yanıtı JSON olarak gelir:

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

jq ile işlemek

Kabuk betiklerinde küçük jq aracı tek tek değerleri çeker. Böylece tüm QR kodlarının adını ve tarama sayısını listeleyebilir ya da yeni bir QR kodunun kimliğini saklayabilirsin:

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"

Betikte hataları tanımak

--json ile hatalar da JSON olarak gelir, üstelik asıl verilerle karışmasın diye hata çıktısına yazılır. Ayrıca dönüş değeri hatanın türünü söyler:

• 0: her şey yolunda.
• 2: yanlış veya eksik girdi, örneğin unutulmuş bir --name.
• 3: oturum açılmamış veya anahtar geçersiz.
• 4: yetki yok, örneğin “salt okunur“ bir anahtar ya da bir tarife sınırı.
• 1: API'den gelen başka bir hata.

Aynı hatayı yüz kez üretmek yerine döngüleri ilk hatada kes, örneğin komutun ardına “|| break“ ekleyerek.

Akış örnekleri

• Bir konum listesi QR kodlarına dönüşür, JSON yanıtları matbaa için bir dosyaya yazılır.
• Aylık bir görev, tarama raporunun dayanağı olarak “sameqr qr list --json“ çıktısını kaydeder.
• Bir kodlama ajanı CLI'yı kendisi çağırır ve sonraki adımları planlamak için JSON yanıtlarını okur.

Sonuç: Neden Same-QR

sameqr CLI betikler için yapıldı: isteğe bağlı JSON, temiz ayrılmış hatalar ve net dönüş değerleri, anahtar komut satırından değil ortamdan. Böylece tekil komutlar güvenilir akışlara dönüşür, Same-QR ile her tarifede.

Hemen başla: sameqr.com'da ücretsiz kaydol, 20 dinamik QR kodu kalıcı olarak ücretsiz. API, CLI ve MCP sunucusu her tarifede var, belgeler sameqr.com/entwickler adresinde.

Sık sorulan sorular