Trackschrijvers en bijdragers (API)

Wanneer je via de openbare LabelGrid API een track aanmaakt, beschrijf je de mensen erachter met twee aparte arrays: één voor songcredits (wie wat deed) en één voor publishingsplits (wie de compositie bezit en met welk percentage). Deze handleiding legt uit wat elke array verwacht en welke regels er gelden zodra je een track aanmaakt.

Twee arrays per track

Elke track draagt twee onafhankelijke arrays:

• contributors[]: songcredits, oftewel wie wat deed op de track.
• writers[]: publishingsplits, oftewel wie de compositie bezit en met welk percentage.

Beide arrays verwijzen naar een schrijversprofiel via writerId (camelCase) of writer_id (snake_case). Stuur er precies één van de twee mee; allebei meesturen wordt geweigerd. De ID moet horen bij een schrijver die jij bezit.

Beide arrays wijzen naar hetzelfde schrijversregister: de schrijvers die je aanmaakt via het Writers-endpoint. Een bijdrager en een schrijver met publishingsplit verwijzen dus naar hetzelfde onderliggende schrijversrecord.

contributors[]: verplicht bij aanmaken

contributors[] is verplicht bij het aanmaken, met minstens één item. Elk item bevat:

• writerId / writer_id
• roles[]: 1 tot 3 rollen, gekozen uit de referentielijst met bijdragerrollen
• ai_contribution: none, partly of all

Regels die in werking treden zodra je een track POST’t:

• Dek alle drie de rolcategorieën: over je bijdragers heen moet er minstens één Performer-rol, één Composition & Lyrics-rol en één Production & Engineering-rol zitten.
• Minstens één mens: ai_contribution mag niet voor elke bijdrager all zijn.
• Geen dubbele schrijvers-ID’s in de contributors-array.

writers[]: publishingsplits (optioneel, maar moeten samen 100% zijn als je ze opgeeft)

writers[] is optioneel bij het aanmaken. Geef je het op, dan bevat elk item:

• writerId / writer_id
• roles[]: minstens één rol; de enige toegestane waarden zijn Composer en Lyricist
• percentage_share: een getal van 0 tot 100

Regels:

• De splits moeten samen 100% zijn: de percentage_share-waarden van alle schrijvers moeten optellen tot 100.
• Geen dubbele schrijvers-ID’s.
• Geen dubbele rollen voor dezelfde schrijver.

Een minimaal voorbeeld

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

Veelvoorkomende fouten

• Gebruik het meervoud roles, niet role.
• Gebruik percentage_share, niet share.
• Stuur niet zowel writerId als writer_id mee op hetzelfde item.
• Voor schrijvers met een publishingsplit worden alleen Composer en Lyricist als rol geaccepteerd.
• Neem je writers[] op, dan moeten de splits exact optellen tot 100%.

Gerelateerd

• API-overzicht: endpoints, authenticatie en de volledige referentie (inclusief de referentiegegevens voor bijdragerrollen)
• Schrijvers en bijdragers: hoe schrijversprofielen werken in je catalogus