Penulis Lagu & Kontributor (API)

Saat Anda membuat sebuah lagu melalui API publik LabelGrid, Anda mendeskripsikan orang-orang di baliknya dengan dua array terpisah: satu untuk kredit lagu (siapa mengerjakan apa) dan satu untuk pembagian hak penerbitan (siapa pemilik komposisi beserta persentasenya). Panduan ini menjelaskan apa yang diharapkan oleh masing-masing array dan aturan yang berjalan ketika Anda membuat lagu.

Dua array per lagu

Setiap lagu membawa dua array yang independen:

• contributors[]: kredit lagu, yaitu siapa mengerjakan apa pada lagu tersebut.
• writers[]: pembagian hak penerbitan, yaitu siapa pemilik komposisi beserta persentasenya.

Kedua array merujuk profil penulis melalui writerId (camelCase) atau writer_id (snake_case). Kirim tepat salah satu dari keduanya; mengirim keduanya akan ditolak. ID harus cocok dengan penulis yang Anda miliki.

Kedua array mengarah ke registri penulis yang sama, yaitu penulis yang Anda buat melalui endpoint Writers. Jadi seorang kontributor dan seorang penulis pembagian hak penerbitan merujuk pada catatan penulis yang sama.

contributors[]: wajib saat pembuatan

contributors[] wajib diisi saat pembuatan, dengan minimal satu entri. Setiap entri memiliki:

• writerId / writer_id
• roles[]: 1 hingga 3 peran, diambil dari daftar referensi Peran Kontributor
• ai_contribution: none, partly, atau all

Aturan yang aktif saat Anda melakukan POST sebuah lagu:

• Cakup ketiga kategori peran: di seluruh kontributor Anda, harus ada minimal satu peran Performer, satu peran Composition & Lyrics, dan satu peran Production & Engineering.
• Minimal satu manusia: ai_contribution tidak boleh all untuk setiap kontributor.
• Tidak boleh ada ID penulis yang sama di seluruh array kontributor.

writers[]: pembagian hak penerbitan (opsional, tetapi harus berjumlah total 100% jika disertakan)

writers[] bersifat opsional saat pembuatan. Jika Anda menyertakannya, setiap entri memiliki:

• writerId / writer_id
• roles[]: minimal satu peran; nilai yang diperbolehkan hanya Composer dan Lyricist
• percentage_share: angka dari 0 hingga 100

Aturan:

• Pembagian harus berjumlah total 100%: nilai percentage_share di seluruh penulis harus berjumlah 100.
• Tidak boleh ada ID penulis yang sama.
• Tidak boleh ada peran yang sama untuk satu penulis.

Contoh minimal

{
  "title": "Track One",
  "contributors": [
    {
      "writerId": "wr_123",
      "roles": ["Vocals", "Composer", "Producer"],
      "ai_contribution": "none"
    }
  ],
  "writers": [
    {
      "writerId": "wr_123",
      "roles": ["Composer", "Lyricist"],
      "percentage_share": 100
    }
  ]
}

Kesalahan umum

• Gunakan bentuk jamak roles, bukan role.
• Gunakan percentage_share, bukan share.
• Jangan kirim writerId dan writer_id sekaligus pada entri yang sama.
• Untuk penulis pembagian hak penerbitan, hanya Composer dan Lyricist yang diterima sebagai peran.
• Jika Anda menyertakan writers[], pembagiannya harus berjumlah tepat 100%.

Terkait

• Gambaran Umum API: endpoint, autentikasi, dan referensi lengkap (termasuk data referensi Peran Kontributor)
• Penulis & Kontributor: cara kerja profil penulis di katalog Anda