Gambaran Umum API

API publik LabelGrid memungkinkan pengembang berintegrasi dengan LabelGrid secara terprogram: membaca katalog Anda, membuat dan memperbarui rilis, mengunggah aset, serta mengirimkan rilis untuk distribusi.

Yang ditawarkan API

API publik dipasang di bawah /api/public/... pada api.labelgrid.com dan menyediakan akses terprogram ke:

• Rilis: daftar, buat, perbarui, hapus; unggah artwork; validasi; kirim untuk distribusi
• Lagu: daftar, buat, perbarui; unggah berkas audio; kelola lisensi lagu
• Label: daftar dan kelola profil label Anda
• Artis: daftar dan kelola profil artis
• Penulis dan Kontributor: daftar dan kelola profil penulis/kontributor
• Penerbit: daftar dan kelola profil penerbit
• Webhook: daftarkan endpoint webhook untuk notifikasi asinkron
• Data referensi: genre, bahasa, peran kontributor, instrumen, wilayah distribusi, dan outlet distribusi

Kasus penggunaan umum

• Mengotomatiskan pembuatan rilis dari sistem yang sudah Anda miliki
• Menyinkronkan data katalog dengan basis data Anda
• Membangun dasbor dan alat pelaporan khusus
• Berintegrasi dengan alat alur kerja yang sudah Anda gunakan
• Menjalankan layanan distribusi white-label di atas LabelGrid

---

Mendapatkan akses API

Untuk menggunakan API LabelGrid, Anda memerlukan:

1. Akun LabelGrid dengan akses API yang aktif pada paketnya
2. Token API yang dibuat dari pengaturan akun Anda: buka menu avatar di pojok kanan atas lalu klik API Tokens (hanya terlihat jika akses API aktif)
3. (Opsional) Whitelist IP untuk keamanan tambahan; konfigurasikan di area yang sama

Jika Anda tidak melihat opsi API Tokens di akun Anda, hubungi dukungan untuk membahas pengaktifan akses API pada paket Anda.

---

Autentikasi

Setiap permintaan API wajib menyertakan Bearer token pada header Authorization:

Authorization: Bearer YOUR_API_TOKEN

---

Dokumentasi API

Untuk referensi endpoint lengkap, skema permintaan/respons, dan alat “try it” langsung, lihat dokumentasi yang dibuat secara otomatis:

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

Dokumentasi mencakup:

• Panduan autentikasi
• Setiap endpoint yang tersedia dengan contoh permintaan dan respons
• Informasi pembatasan laju (rate limiting)
• Konfigurasi webhook

---

Sandbox

LabelGrid menyediakan lingkungan sandbox sehingga Anda dapat membangun dan menguji terhadap API tanpa memengaruhi katalog produksi Anda. Akun sandbox disediakan atas permintaan. Hubungi dukungan untuk menyiapkannya.

---

Webhook

API publik mendukung webhook untuk notifikasi peristiwa asinkron (perubahan status peninjauan, pembaruan pengiriman, dan lain-lain). Lihat Webhook untuk penyiapan dan jenis peristiwa yang tersedia.

---

Terkait

Sedang membangun di atas API LabelGrid? Lihat hub pengembang untuk gambaran umum tentang apa saja yang mungkin dilakukan. Jika Anda menjalankan layanan distribusi white-label di atas LabelGrid, halaman infrastruktur untuk distributor membahas gambaran yang lebih luas.

---

Butuh Bantuan?

Jika Anda membutuhkan bantuan terkait API, hubungi tim dukungan kami dengan detail teknis tentang integrasi Anda.