API'ye Genel Bakış

LabelGrid herkese açık API’si, geliştiricilerin LabelGrid ile programatik olarak entegre olmasını sağlar: kataloğunuzu okuyabilir, yayın oluşturup güncelleyebilir, içerik dosyaları yükleyebilir ve yayınları dağıtıma gönderebilirsiniz.

API ne sunar

Herkese açık API, api.labelgrid.com üzerinde /api/public/... altında yer alı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ıma gönderme
• Parçalar: listeleme, oluşturma, güncelleme; ses dosyası yükleme; parça lisanslarını yönetme
• Etiketler (label): 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: eşzamansız bildirimler için webhook uç noktaları kaydetme
• Referans veriler: 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 eşitleyin
• Özel panolar ve raporlama araçları geliştirin
• Mevcut iş akışı araçlarınızla entegre edin
• LabelGrid üzerinde markasız (white-label) dağıtım hizmetleri sunun

---

API erişimi edinme

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

1. Planında API erişimi etkin olan bir LabelGrid hesabı
2. Hesap ayarlarınızdan oluşturulmuş bir API anahtarı (token): sağ üstteki avatar menüsünü açın ve API Tokens seçeneğine tıklayın (yalnızca API erişimi etkinse görünür)
3. (İsteğe bağlı) Ek güvenlik için IP beyaz listesi (aynı bölümden yapılandırılır)

Hesabınızda API Tokens seçeneğini görmüyorsanız, planınızda API erişimini etkinleştirmek için destek ekibimizle iletişime geçin.

---

Kimlik doğrulama

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

Authorization: Bearer YOUR_API_TOKEN

---

API Belgeleri

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

• Production: https://api.labelgrid.com/docs/api
• Sandbox: https://api-sandbox.stg.labelgrid.com/docs/api

Belgeler şunları içerir:

• Kimlik doğrulama rehberi
• İstek ve yanıt örnekleriyle birlikte mevcut her uç nokta
• Hız sınırlaması (rate-limiting) bilgileri
• Webhook yapılandırması

---

Sandbox

LabelGrid, production kataloğunuzu etkilemeden API’ye karşı geliştirme ve test yapabilmeniz için bir sandbox ortamı sunar. Sandbox hesapları talep üzerine sağlanır; oluşturmak için destek ekibimizle iletişime geçin.

---

Webhook’lar

Herkese açık API, eşzamansız olay bildirimleri (inceleme durumu değişiklikleri, teslimat güncellemeleri vb.) için webhook’ları destekler. Kurulum ve kullanılabilir olay türleri için Webhook’lar sayfasına bakın.

---

İlgili konular

LabelGrid API’si üzerine bir şeyler mi geliştiriyorsunuz? Nelerin mümkün olduğuna dair genel bir bakış için geliştirici merkezine göz atın. LabelGrid üzerinde markasız (white-label) bir dağıtım hizmeti yürütüyorsanız, dağıtımcılar için altyapı sayfası daha geniş tabloyu ele alır.

---

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

API konusunda yardıma ihtiyacınız varsa, entegrasyonunuza dair teknik ayrıntılarla birlikte destek ekibimizle iletişime geçin.