İçeriğe geç
Help Center
Destek

LabelGrid Komut Satırı Aracı (CLI)

Temmuz 2026’da güncellendi.

LabelGrid, hesabınızla doğrudan terminalden veya bir betikten çalışabilmeniz için resmi bir komut satırı aracı yayımlar. Bu araç @labelgrid/cli adlı npm paketidir ve kurulduğunda makinenize bir labelgrid komutu ekler.

CLI, LabelGrid herkese açık API’sinin ince bir sarmalayıcısıdır: aynı yüzey, aynı doğrulama, aynı izinler. Herkese açık API’nin izin verdiği her şeyi CLI de yapabilir; API’nin reddettiği her şeyi CLI de tam olarak aynı şekilde reddeder. Bir yapay zeka asistanıyla gündelik dilde çalışmayı tercih ediyorsanız, LabelGrid aynı API üzerine kurulu bir MCP sunucusu da yayımlar.

Neler yapabilirsiniz

Section titled “Neler yapabilirsiniz”

Komutlar gruplar halinde düzenlenmiştir. Terminalinizden şunları yapabilirsiniz:

  • auth — oturum açma, oturum kapatma, hangi hesapla oturum açtığınızı görme ve bir jetonu iptal etme
  • catalog — etiketleri, sanatçıları, söz yazarlarını, yayıncıları, yayınları ve parçaları arama, görüntüleme, oluşturma, güncelleme ve silme
  • release — bir yayını doğrulama, dağıtıma gönderme, kaldırma, incelemeyi onaylama, açılış sayfasını ve kısa bağlantısını yönetme
  • upload — ses, kapak görseli, şarkı sözü ve hareketli kapak ekleme (her tür yalnızca kendi izin verilen dosya uzantılarını kabul eder)
  • download, asset, license — dosyaları alma ve lisansları yönetme
  • statement, transactions, royalties, analytics — ekstreleri, işlemleri, telif geliri dökümlerini ve akış analizlerini çekme
  • review — inceleme sorunlarını görüntüleme, kalite raporlarını okuma ve not ekleme
  • webhook — asenkron bildirimler için webhook kaydetme ve yönetme
  • beatport — Beatport etkinleştirmesini yönetme

Neye ihtiyacınız var

Section titled “Neye ihtiyacınız var”
  1. API erişimi olan bir LabelGrid hesabı. API erişimi, LabelGrid’in API planlarının bir parçasıdır; nasıl edineceğiniz için bkz. API’ye Genel Bakış.
  2. Bir API jetonu. LabelGrid panonuzda Profil → API Jetonları altından oluşturun.
  3. CLI’yi çalıştıracağınız bilgisayarda Node.js 20 veya üzeri.

Kurulum

Section titled “Kurulum”

CLI’yi npm ile global olarak kurun:

Terminal window
npm install -g @labelgrid/cli

Bu, labelgrid komutunu ekler. Kurulumun başarılı olduğunu şöyle doğrulayın:

Terminal window
labelgrid --version

Kimlik doğrulama

Section titled “Kimlik doğrulama”

CLI, API jetonunuza ihtiyaç duyar. Jetonu şu üç yerde, bu sırayla arar:

  1. LABELGRID_API_TOKEN ortam değişkeni — betikler ve CI için en uygunu.
  2. labelgrid auth login ile bir kez kaydettiğiniz saklanmış kimlik bilgisi. macOS’ta bu Anahtar Zinciri’nde tutulur; diğer sistemlerde ~/.config/labelgrid/ altında izinleri kısıtlanmış bir dosyaya kaydedilir.
  3. Tek bir komuta eklenen --token bayrağı.

CLI’yi bir ortam değişkenine yönlendirin:

Terminal window
export LABELGRID_API_TOKEN=your-api-token
labelgrid auth whoami

Ya da jetonu bir kez saklayın ve CLI’nin yeniden kullanmasına izin verin:

Terminal window
labelgrid auth login

CLI jeton değerlerini hiçbir zaman ekrana yazdırmaz. Erişimi durdurmak için labelgrid auth logout ile oturumu kapatın veya jetonu panonuzdan iptal edin; iptal anında geçerli olur.

Çıktı ve çıkış kodları

Section titled “Çıktı ve çıkış kodları”

CLI varsayılan olarak temiz, insan tarafından okunabilir bir çıktı verir. Betik yazarken herhangi bir komuta --json ekleyin; ham API yanıtını yazdırır ve başka araçlara aktarabilirsiniz:

Terminal window
labelgrid catalog search releases --query "summer" --json

Komutlar standart çıkış kodları döndürür; böylece betikleriniz sonuca göre davranabilir:

Çıkış koduAnlamı
0Başarılı
1API hatası (istek LabelGrid’e ulaştı ve reddedildi)
2Kullanım hatası (komutun kendisinde bir hata var)

Güvenlik

Section titled “Güvenlik”

Kesin sonuç doğuran ve geri alınamayan komutlar, hiçbir şey gönderilmeden önce onay ister. Bir yayını dağıtıma gönderme, bir yayını kaldırma, incelemeyi onaylama, katalog ögelerini silme ve Beatport’u etkinleştirme işlemlerinin tümünde CLI, herhangi bir API çağrısı yapmadan önce onaylamanız için y yazmanızı ister.

Klavye başında kimsenin olmadığı otomasyonlarda, istemi atlamak için --yes ekleyin:

Terminal window
labelgrid release distribute REL123 --yes

Hesabınıza ilişkin tüm korumalar (doğrulama, plan limitleri ve hız sınırları) LabelGrid’in sunucularında uygulanır; dolayısıyla CLI’yi nasıl çalıştırırsanız çalıştırın bunları aşamaz.

Sorun giderme

Section titled “Sorun giderme”
  • command not found: labelgrid — global kurulum tamamlanmamış veya PATH üzerinde değil. npm install -g @labelgrid/cli komutunu yeniden çalıştırın ve node --version ile Node.js 20 veya üzerini doğrulayın.
  • Jeton geçersiz veya reddedildi — jetonu panonuzda Profil → API Jetonları altından yeniden oluşturun, ardından export LABELGRID_API_TOKEN=... veya labelgrid auth login ile yeniden tanımlayın.
  • “API Jetonları” sayfasını göremiyorsunuz — hesabınızın henüz API erişimi yok. Nasıl etkinleştireceğiniz için bkz. API’ye Genel Bakış.
  • Bir komut betikte başarısız oluyor — çıkış kodunu kontrol edin (1 API hatası, 2 kullanım hatasıdır) ve tam yanıtı okumak için aynı komutu --json ile yeniden çalıştırın.

SSS

Section titled “SSS”

”LabelGrid’in bir komut satırı aracı var mı?”

Section titled “”LabelGrid’in bir komut satırı aracı var mı?””

Evet. LabelGrid, resmi CLI’yi @labelgrid/cli adlı npm paketi olarak yayımlar. npm install -g @labelgrid/cli komutuyla kurulur ve terminalinize bir labelgrid komutu ekler. Node.js 20 veya üzerini gerektirir ve LabelGrid herkese açık API’sinin ince bir sarmalayıcısıdır.

”Bununla neler yapabilirim?”

Section titled “”Bununla neler yapabilirim?””

Oturum açma ve jeton yönetimi; etiketleri, sanatçıları, söz yazarlarını, yayıncıları, yayınları ve parçaları arama, görüntüleme, oluşturma, güncelleme ve silme; ses, kapak görseli, şarkı sözü ve hareketli kapak yükleme; yayınları doğrulama, dağıtıma gönderme ve kaldırma; ekstreleri, işlemleri, telif gelirlerini ve akış analizlerini çekme; inceleme sorunlarını ve kalite raporlarını görüntüleme; webhook’ları ve Beatport etkinleştirmesini yönetme.

”CLI’de kimlik doğrulamayı nasıl yaparım?”

Section titled “”CLI’de kimlik doğrulamayı nasıl yaparım?””

Bir LabelGrid API jetonuyla. CLI jetonu şu üç yerde, bu sırayla arar: LABELGRID_API_TOKEN ortam değişkeni, ardından labelgrid auth login ile saklanan kimlik bilgisi, ardından --token bayrağı. CLI jeton değerlerini hiçbir zaman ekrana yazdırmaz.

”Bir API planına ihtiyacım var mı?”

Section titled “”Bir API planına ihtiyacım var mı?””

Evet. CLI, LabelGrid herkese açık API’si üzerinden bağlanır; bu nedenle hesabınızın API erişimi olmalıdır ve API erişimi LabelGrid’in API planlarının bir parçasıdır. Erişimi nasıl edineceğiniz için bkz. API’ye Genel Bakış.

”CLI ile MCP sunucusu arasındaki fark nedir?”

Section titled “”CLI ile MCP sunucusu arasındaki fark nedir?””

İkisi de aynı herkese açık API üzerine kurulu resmi LabelGrid araçlarıdır. CLI terminaliniz ve betikleriniz içindir; MCP sunucusu ise API çağrılarını sizin yerinize gündelik dille yapan Claude ve Cursor gibi yapay zeka asistanları içindir. İş akışınıza hangisi uyuyorsa onu, isterseniz her ikisini birden kullanın.

İlgili

Section titled “İlgili”

Yardıma mı ihtiyacınız var?

Section titled “Yardıma mı ihtiyacınız var?”

CLI hakkında sorularınız varsa destek ekibimizle iletişime geçin.

LabelGrid’i henüz kullanmıyor musunuz?

Az önce okuduklarınızın tamamı platformumuzda mevcut.

LabelGrid’in neler yapabileceğini keşfedin →