Parça Yazarları ve Katkıda Bulunanlar (API)

LabelGrid herkese açık API’si üzerinden bir parça oluşturduğunuzda, parçanın arkasındaki kişileri iki ayrı dizi ile tanımlarsınız: biri şarkı kredileri (kimin ne yaptığı), diğeri yayıncılık payları (eserin sahibi ve yüzdesi) içindir. Bu rehber, her dizinin neyi beklediğini ve parça oluştururken çalışan kuralları açıklar.

Parça başına iki dizi

Her parça, birbirinden bağımsız iki dizi taşır:

• contributors[]: şarkı kredileri, yani parçada kimin ne yaptığı.
• writers[]: yayıncılık payları, yani eserin sahibi ve yüzdesi.

Her iki dizi de bir yazar profiline writerId (camelCase) veya writer_id (snake_case) ile referans verir. İkisinden yalnızca birini gönderin; ikisini birden göndermek reddedilir. ID, sahibi olduğunuz bir yazarla eşleşmelidir.

Her iki dizi de aynı yazar kaydını işaret eder: Writers uç noktası üzerinden oluşturduğunuz yazarlar. Yani bir katkıda bulunan ile bir yayıncılık payı yazarı, aynı temel yazar kaydına referans verir.

contributors[]: oluştururken zorunlu

contributors[], oluşturma sırasında zorunludur ve en az bir kayıt içermelidir. Her kayıt şunları içerir:

• writerId / writer_id
• roles[]: Katkıda Bulunan Rolleri referans listesinden seçilen 1 ila 3 rol
• ai_contribution: none, partly veya all

Bir parçayı POST ettiğinizde çalışan kurallar:

• Üç rol kategorisinin tamamını karşılayın: katkıda bulunanlarınız arasında en az bir Performer, bir Composition & Lyrics ve bir Production & Engineering rolü bulunmalıdır.
• En az bir insan: her katkıda bulunan için ai_contribution değeri all olamaz.
• Katkıda bulunanlar dizisinde yinelenen yazar ID’leri bulunamaz.

writers[]: yayıncılık payları (isteğe bağlı, ancak gönderilirse toplamı %100 olmalı)

writers[], oluşturma sırasında isteğe bağlıdır. Eklerseniz, her kayıt şunları içerir:

• writerId / writer_id
• roles[]: en az bir rol; izin verilen tek değerler Composer ve Lyricist
• percentage_share: 0 ile 100 arasında bir sayı

Kurallar:

• Payların toplamı %100 olmalıdır: tüm yazarlardaki percentage_share değerlerinin toplamı 100 olmalıdır.
• Yinelenen yazar ID’leri bulunamaz.
• Tek bir yazar için yinelenen roller bulunamaz.

Asgari bir örnek

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

Sık karşılaşılan hatalar

• role değil, çoğul biçim olan roles kullanın.
• share değil, percentage_share kullanın.
• Aynı kayıtta hem writerId hem de writer_id göndermeyin.
• Yayıncılık payı yazarları için rol olarak yalnızca Composer ve Lyricist kabul edilir.
• writers[] eklerseniz, payların toplamı tam olarak %100 olmalıdır.

İlgili konular

• API’ye Genel Bakış: uç noktalar, kimlik doğrulama ve tam referans (Katkıda Bulunan Rolleri referans verileri dâhil)
• Yazarlar ve Katkıda Bulunanlar: yazar profillerinin kataloğunuzda nasıl çalıştığı