Auteurs et contributeurs de piste (API)

Lorsque vous créez une piste via l’API publique de LabelGrid, vous décrivez les personnes qui se trouvent derrière avec deux tableaux distincts : un pour les crédits de la chanson (qui a fait quoi) et un pour les répartitions d’édition (qui possède la composition et son pourcentage). Ce guide explique ce qu’attend chaque tableau et les règles qui s’appliquent à la création d’une piste.

Deux tableaux par piste

Chaque piste comporte deux tableaux indépendants :

• contributors[] — crédits de la chanson : qui a fait quoi sur la piste.
• writers[] — répartitions d’édition : qui possède la composition et son pourcentage.

Les deux tableaux référencent un profil d’auteur via writerId (camelCase) ou writer_id (snake_case). Envoyez exactement l’un des deux — envoyer les deux est rejeté. L’ID doit correspondre à un auteur que vous possédez.

Les deux tableaux pointent vers le même registre d’auteurs — les auteurs que vous créez via le point de terminaison Writers. Ainsi, un contributeur et un auteur de répartition d’édition référencent le même enregistrement d’auteur sous-jacent.

contributors[] — requis à la création

contributors[] est requis à la création, avec au moins une entrée. Chaque entrée comporte :

• writerId / writer_id
• roles[] — de 1 à 3 rôles, tirés de la liste de référence des Rôles de contributeur
• ai_contribution — none, partly ou all

Règles qui s’appliquent lors d’un POST de piste :

• Couvrir les trois catégories de rôle — parmi vos contributeurs, il doit y avoir au moins un rôle d’Interprète (Performer), un de Composition et paroles (Composition & Lyrics) et un de Production et ingénierie (Production & Engineering).
• Au moins une personne — ai_contribution ne peut pas être all pour tous les contributeurs.
• Pas d’ID d’auteur en double dans le tableau des contributeurs.

writers[] — répartitions d’édition (facultatif, mais doit totaliser 100 % si présent)

writers[] est facultatif à la création. Si vous l’incluez, chaque entrée comporte :

• writerId / writer_id
• roles[] — au moins un rôle ; les seules valeurs autorisées sont Composer et Lyricist
• percentage_share — un nombre de 0 à 100

Règles :

• Les répartitions doivent totaliser 100 % — les valeurs de percentage_share de tous les auteurs doivent totaliser 100.
• Pas d’ID d’auteur en double.
• Pas de rôles en double pour un même auteur.

Un exemple 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
    }
  ]
}

Erreurs courantes

• Utilisez le pluriel roles, pas role.
• Utilisez percentage_share, pas share.
• N’envoyez pas writerId et writer_id sur la même entrée.
• Pour les auteurs de répartition d’édition, seuls Composer et Lyricist sont acceptés comme rôles.
• Si vous incluez writers[], les répartitions doivent totaliser exactement 100 %.

Ressources associées

• Aperçu de l’API — points de terminaison, authentification et la référence complète (y compris les données de référence des Rôles de contributeur)
• Auteurs et contributeurs — comment fonctionnent les profils d’auteur dans votre catalogue