API'ye Genel Bakış ve Hızlı Başlangıç

Temmuz 2026’da güncellendi.

Evet, LabelGrid programatik dağıtım için herkese açık bir REST API sunar. Geliştiricilerin kataloğunuzu okumasına, yayınlar oluşturup güncellemesine, varlıklar yüklemesine ve yayınları dağıtım için göndermesine olanak tanır; ayrıca LabelGrid üzerine kurulu beyaz etiketli hizmetlerin altyapısını da oluşturur. Bu kılavuz hızlı başlangıçtır; eksiksiz uç nokta referansı api.labelgrid.com/docs/api adresinde yer alır.

Bir bakışta hızlı başlangıç

Adım	Ne yaparsınız
1. Bir API planı etkinleştirin	API ve sandbox erişimi aktif, ücretli bir API planı gerektirir (yıllık faturalandırılır).
2. Bir API jetonu oluşturun	Sağ üstteki avatar menüsünü açın ve Bearer jetonu oluşturmak için API Jetonları’na tıklayın.
3. (İsteğe bağlı) IP beyaz listesi	Aynı API Jetonları alanından jeton kullanımını bilinen IP’lerle sınırlayın.
4. Referansı okuyun	Uç noktaları ve “dene” araçlarını api.labelgrid.com/docs/api adresinde inceleyin.
5. Sandbox üzerinde geliştirin	Destekten bir sandbox talep edin, ardından üretime dokunmadan test edin.
6. Üretime geçin	Entegrasyonunuzu `api.labelgrid.com` adresine yönlendirin ve ilk yayınınızı oluşturun.

API’nin Sunduğu Olanaklar

Herkese açık API, api.labelgrid.com üzerinde /api/public/... altında konumlanır ve şunlara programatik erişim sağlar:

Yayınlar — listeleme, oluşturma, güncelleme, silme; kapak görseli yükleme; doğrulama; dağıtım için gönderme
Parçalar — listeleme, oluşturma, güncelleme; ses dosyaları yükleme; parça lisanslarını yönetme
Etiketler — etiket profillerinizi listeleme ve yönetme
Sanatçılar — sanatçı profillerini listeleme ve yönetme
Yazarlar ve Katkıda Bulunanlar — yazar/katkıda bulunan profillerini listeleme ve yönetme
Yayıncılar — yayıncı profillerini listeleme ve yönetme
Webhook’lar — asenkron bildirimler için webhook uç noktaları kaydetme
Referans verileri — türler, diller, katkıda bulunan rolleri, enstrümanlar, dağıtım bölgeleri, dağıtım kanalları

Yaygın Kullanım Senaryoları

Mevcut sistemlerinizden yayın oluşturmayı otomatikleştirin
Katalog verilerini veritabanınızla senkronize edin
Özel kontrol panelleri ve raporlama araçları oluşturun
Mevcut iş akışı araçlarınızla entegre olun
LabelGrid üzerinde beyaz etiketli dağıtım hizmetlerine güç verin

API Erişimi Edinme

LabelGrid API’sini kullanmak için şunlara ihtiyacınız vardır:

Aktif, ücretli bir API planı — API ve sandbox erişimi ücretli bir API planı gerektirir. Standart planlarla birlikte gelen 7 günlük ücretsiz deneme, API veya sandbox erişimini içermez ve API planları derhal faturalandırılır (deneme süresi yoktur).
Hesap ayarlarınızdan oluşturulan bir API jetonu: sağ üstteki avatar menüsünü açın ve API Jetonları’na tıklayın (yalnızca API erişimi etkinse görünür)
(İsteğe bağlı) Ek güvenlik için IP beyaz listesi — aynı alan altında yapılandırın

Hesabınızda API Jetonları seçeneğini görmüyorsanız, planınızda API erişimini etkinleştirmeyi görüşmek için destekle iletişime geçin.

Kimlik Doğrulama

Tüm API istekleri, Authorization başlığında bir Bearer jetonu içermelidir:

Authorization: Bearer YOUR_API_TOKEN

API Belgeleri

Eksiksiz uç nokta referansı, istek/yanıt şemaları ve canlı “dene” araçları için otomatik oluşturulan belgelere bakın:

Üretim: https://api.labelgrid.com/docs/api
Sandbox: https://api-sandbox.stg.labelgrid.com/docs/api

Belgeler şunları içerir:

Kimlik doğrulama kılavuzu
İstek ve yanıt örnekleriyle mevcut her uç nokta
Hız sınırlama bilgileri
Webhook yapılandırması

Sandbox

LabelGrid, üretim kataloğunuzu etkilemeden API üzerinde geliştirme ve test yapabilmeniz için bir sandbox ortamı sunar. Sandbox erişimi aktif bir API planı gerektirir ve istek üzerine bizim tarafımızdan sağlanır — API planınız aktif olduğunda, bir tane ayarlamak için destekle iletişime geçin. Sandbox IP beyaz listesini sizin için yapılandırırız; üretim IP beyaz listesi API Jetonları altında kendi kendine yapılır.

Webhook’lar

Herkese açık API, asenkron olay bildirimi (inceleme durumu değişiklikleri, teslimat güncellemeleri vb.) için webhook’ları destekler. Kurulum ve kullanılabilir olay türleri için bkz. Webhook’lar.

SSS

”LabelGrid’in herkese açık bir API’si var mı?”

Evet, LabelGrid programatik dağıtım için api.labelgrid.com üzerinde /api/public/... yolundan sunulan herkese açık bir REST API sunar. Kataloğunuzu okuyabilir, yayınlar oluşturup güncelleyebilir, ses ve kapak görseli yükleyebilir, sanatçıları ve katkıda bulunanları yönetebilir, webhook kaydedebilir ve yayınları dağıtım için gönderebilirsiniz. Eksiksiz belgeler api.labelgrid.com/docs/api adresindedir.

”API erişimini nasıl edinirim?”

API ve sandbox erişimi aktif, ücretli bir API planı gerektirir. API planınız aktif olduğunda, hesap ayarlarınızdaki API Jetonları alanından (sağ üstteki avatar menüsünde) bir API jetonu oluşturun. Bu seçeneği görmüyorsanız, API erişimini etkinleştirmek için destek ekibiyle iletişime geçin. Standart planlardaki 7 günlük ücretsiz deneme API erişimi içermez.

”API isteklerinde kimlik doğrulamayı nasıl yaparım?”

Her isteğin Authorization başlığına bir Bearer jetonu ekleyin: Authorization: Bearer YOUR_API_TOKEN. Jetonu hesap ayarlarınızdaki API Jetonları alanından oluşturun ve isterseniz IP beyaz listesiyle sınırlandırın.

”Test için bir sandbox ortamı var mı?”

Evet. LabelGrid, üretim kataloğunuzu etkilemeden API üzerinde geliştirme ve test yapabilmeniz için bir sandbox sunar. Sandbox erişimi aktif bir API planı gerektirir ve istek üzerine sağlanır; API planınız aktif olduğunda destek ekibiyle iletişime geçin. Sandbox belgeleri api-sandbox.stg.labelgrid.com/docs/api adresindedir.

”LabelGrid API’sinin maliyeti nedir?”

API, LabelGrid’in yıllık faturalandırılan API planlarıyla sunulur. Planlar Starter API kademesiyle başlar; daha büyük kataloglar ve daha yüksek telif geliri işleme limitleri için üst kademeler bulunur. Güncel fiyatlar ve kademe ayrıntıları için fiyatlandırma sayfasına bakın.

İlgili

LabelGrid API’si üzerinde geliştirme mi yapıyorsunuz? Nelerin mümkün olduğuna dair genel bir bakış için geliştirici merkezine bakın. LabelGrid üzerinde beyaz etiketli bir dağıtım hizmetine güç veriyorsanız, dağıtımcılar için altyapı sayfası daha büyük resmi kapsar. Ayrıca bkz. White-label dağıtım kurulumu kılavuzu.

Yardıma mı İhtiyacınız Var?

API yardımına ihtiyacınız varsa, entegrasyonunuzla ilgili teknik ayrıntılarla 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 →