Komut satırıyla QR kod: sameqr CLI'ı kur ve kullan

Neden komut satırı

CLI (Command Line Interface), terminalde metin komutlarıyla kullandığın bir programdır. Bir komut tekrarlanabilir, bir betiğe yazılabilir, başka araçlarla zincirlenebilir ve bir kodlama ajanı tarafından çalıştırılabilir. sameqr CLI, Same-QR'ı tam olarak oraya getirir. Başka bağımlılığı yoktur ve yalnızca Node.js 18 ve üzeri sürümü gerekir.

Adım 1: Kur

CLI, Node.js'in paket yöneticisi olan npm ile gelir:

npm install -g sameqr
sameqr --version

Adım 2: API anahtarı oluştur

Panelde Hesap altında “CLI, betikler ve ajanlar için erişim” bölümünü bulursun. Orada bir anahtar oluştur. Başlangıç için “okuma + yazma” yeterli: oluşturma, ad ve metinleri değiştirme. Mevcut QR kodların hedeflerini değiştirmek, sayfaları çevrimdışı almak veya silmek isteyen “tam”ı seçer. Anahtar sqr_live_ ile başlar ve yalnızca bir kez gösterilir. Hemen şifre yöneticine kaydet.

Adım 3: Giriş yap

Anahtar asla argüman olarak verilmez, yoksa kabuk geçmişinde görünürdü. “sameqr login” anahtarı gizli olarak sorar, doğrular ve yalnızca senin okuyabileceğin şekilde ~/.config/sameqr/config.json dosyasına kaydeder. Alternatif olarak her zaman öncelikli olan SAMEQR_API_KEY ortam değişkenini ayarlarsın.

sameqr login
sameqr whoami

“sameqr whoami” hesabını, tarifeni ve kaç QR kod oluşturabileceğini gösterir.

Adım 4: İlk QR kodunu oluştur

sameqr qr create --name "Speisekarte Tische" --url https://example.com/karte
sameqr qr list
sameqr qr update <id> --url https://example.com/winterkarte
sameqr qr stats <id>

--slug ile oluştururken kendi kısa bağlantını belirlersin, --label ile etiketler eklersin. Etiketlerin kimliklerini “sameqr labels list” gösterir. Hedef değiştirme, çevrimdışı alma ve silme için “tam” anahtar gerekir. CLI o zaman terminalde sorar, terminalsiz betiklerde yalnızca açık bir --yes ile olur. API üzerinden bu tür değişikliklerden saatte en fazla 10 ve günde 30 yapılabilir.

Adım 5: Misafir sayfaları ve menüler

sameqr seite create --vorlage speisekarte --name "Gasthof zum Löwen"
sameqr karte import karte-1.jpg karte-2.jpg --seite menu/gasthof-zum-loewen
sameqr seite publish menu/gasthof-zum-loewen
sameqr qr create --name "Tischaufsteller" --seite menu/gasthof-zum-loewen

“seite create” yeni sayfanın adresini verir, örnekte menu/gasthof-zum-loewen. Sonraki komutlar için buna ihtiyacın var. Sayfa taslak olarak oluşur. “karte import” fotoğrafları yapay zekayla okur ve tanınan grupları hiçbir şeyin üzerine yazmadan sayfaya ekler. Yayımlamadan önce taslağı gözden geçir. Yayımlamak için işletmeci bilgilerinin doldurulmuş olması gerekir. Son komut doğrudan sayfaya yönlendiren bir QR kod oluşturur. Diğer şablonlar: preisliste, zeiten, links, aktion, weingut, etikett ve kontakt.

Adım 6: Betiklerde --json ile

Bir komuta --json eklersen yanıt JSON olarak gelir. Hatalar da JSON olarak hata çıktısına düşer ve dönüş değeri türü belli eder: 3 giriş yapılmamış, 4 eksik yetki, 2 hatalı girdi demektir. Böylece bir betik metni yorumlamak yerine hedefli tepki verir.

sameqr qr list --json

Sonuç: Neden Same-QR

sameqr CLI, Same-QR'ın tüm işlev kapsamını terminale getirir: QR kodlar, istatistik, misafir sayfaları, fotoğraflardan menüler, etiketler ve projeler. Hafiftir, anahtarına özenle davranır ve betikler ile kodlama ajanları için JSON konuşur. Üstelik her tarifede çalışır.

Hemen başla: sameqr.com adresinde ücretsiz kaydol, 20 dinamik QR kod kalıcı olarak ücretsizdir. API, CLI ve MCP sunucusu her tarifede vardır, dokümantasyon sameqr.com/entwickler adresindedir.

Sık sorulan sorular