Aperçu de l'API

L’API publique de LabelGrid permet aux développeurs de s’intégrer à LabelGrid par programmation — consulter votre catalogue, créer et mettre à jour des sorties, importer des fichiers et soumettre des sorties à la distribution.

Ce que propose l’API

L’API publique est exposée sous /api/public/... sur api.labelgrid.com et offre un accès programmatique à :

Sorties — lister, créer, mettre à jour, supprimer ; importer la pochette ; valider ; soumettre à la distribution
Pistes — lister, créer, mettre à jour ; importer des fichiers audio ; gérer les licences de pistes
Labels — lister et gérer vos profils de label
Artistes — lister et gérer les profils d’artistes
Auteurs et contributeurs — lister et gérer les profils d’auteurs/contributeurs
Éditeurs — lister et gérer les profils d’éditeurs
Webhooks — enregistrer des points de terminaison webhook pour des notifications asynchrones
Données de référence — genres, langues, rôles de contributeurs, instruments, territoires de distribution, points de vente distro

Cas d’usage courants

Automatiser la création de sorties depuis vos systèmes existants
Synchroniser les données de catalogue avec votre base de données
Créer des tableaux de bord et des outils de reporting sur mesure
Vous intégrer à vos outils de workflow existants
Alimenter des services de distribution en marque blanche bâtis sur LabelGrid

Obtenir l’accès à l’API

Pour utiliser l’API de LabelGrid, il vous faut :

Un forfait API actif et payant — l’accès à l’API et au sandbox nécessite un forfait API payant. L’essai gratuit de 7 jours fourni avec les forfaits standard ne comprend pas l’accès à l’API ni au sandbox, et les forfaits API sont facturés immédiatement (pas de période d’essai).
Un jeton API généré depuis les réglages de votre compte : ouvrez le menu de l’avatar en haut à droite et cliquez sur Jetons API (visible uniquement si l’accès API est activé)
(Facultatif) Le filtrage d’adresses IP pour plus de sécurité — à configurer dans la même zone

Si l’option Jetons API n’apparaît pas dans votre compte, contactez le support pour discuter de l’activation de l’accès API sur votre forfait.

Authentification

Toutes les requêtes API doivent inclure un jeton Bearer dans l’en-tête Authorization :

Authorization: Bearer YOUR_API_TOKEN

Documentation de l’API

Pour la référence complète des points de terminaison, les schémas de requête/réponse et l’outillage « essayer en direct », consultez la documentation générée automatiquement :

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

La documentation comprend :

Un guide d’authentification
Chaque point de terminaison disponible avec des exemples de requête et de réponse
Des informations sur la limitation du débit (rate limiting)
La configuration des webhooks

Sandbox

LabelGrid propose un environnement sandbox pour vous permettre de développer et de tester avec l’API sans affecter votre catalogue de production. L’accès au sandbox nécessite un forfait API actif et est provisionné par nos soins sur demande — une fois votre forfait API actif, contactez le support pour en configurer un. Nous configurons le filtrage d’IP du sandbox pour vous ; le filtrage d’IP de production est en libre-service sous Jetons API.

Webhooks

L’API publique prend en charge les webhooks pour la notification asynchrone d’événements (changements de statut de révision, mises à jour de livraison, etc.). Consultez Webhooks pour la configuration et les types d’événements disponibles.

En lien

Vous développez sur l’API de LabelGrid ? Consultez le hub développeurs pour un aperçu des possibilités. Si vous alimentez un service de distribution en marque blanche bâti sur LabelGrid, la page infrastructure pour distributeurs couvre la vue d’ensemble.

Besoin d’aide ?

Si vous avez besoin d’aide concernant l’API, contactez notre équipe de support avec les détails techniques de votre intégration.

Vous n’utilisez pas encore LabelGrid ?

Tout ce que vous venez de lire est disponible sur notre plateforme.

Découvrez ce que LabelGrid peut faire →