API-Überblick

Die öffentliche LabelGrid-API ermöglicht Entwicklern eine programmatische Integration mit LabelGrid – Ihren Katalog lesen, Releases erstellen und aktualisieren, Assets hochladen und Releases zum Vertrieb einreichen.

Was die API bietet

Die öffentliche API ist unter /api/public/... auf api.labelgrid.com eingebunden und bietet programmatischen Zugriff auf:

Releases – auflisten, erstellen, aktualisieren, löschen; Artwork hochladen; validieren; zum Vertrieb einreichen
Tracks – auflisten, erstellen, aktualisieren; Audiodateien hochladen; Track-Lizenzen verwalten
Labels – Ihre Label-Profile auflisten und verwalten
Künstler – Künstlerprofile auflisten und verwalten
Autoren und Mitwirkende – Autoren-/Mitwirkenden-Profile auflisten und verwalten
Verlage – Verlagsprofile auflisten und verwalten
Webhooks – Webhook-Endpunkte für asynchrone Benachrichtigungen registrieren
Referenzdaten – Genres, Sprachen, Mitwirkendenrollen, Instrumente, Vertriebsterritorien, Vertriebs-Outlets

Häufige Anwendungsfälle

Die Release-Erstellung aus Ihren bestehenden Systemen automatisieren
Katalogdaten mit Ihrer Datenbank synchronisieren
Eigene Dashboards und Reporting-Tools erstellen
Mit Ihren bestehenden Workflow-Tools integrieren
White-Label-Vertriebsdienste auf Basis von LabelGrid betreiben

API-Zugang erhalten

Um die LabelGrid-API zu nutzen, benötigen Sie:

Einen aktiven, kostenpflichtigen API-Tarif – API- und Sandbox-Zugang erfordern einen kostenpflichtigen API-Tarif. Die 7-tägige kostenlose Testphase, die zu Standardtarifen gehört, umfasst keinen API- oder Sandbox-Zugang, und API-Tarife werden sofort abgerechnet (keine Testphase).
Ein API-Token, das in Ihren Kontoeinstellungen generiert wird: Öffnen Sie das Avatar-Menü oben rechts und klicken Sie auf API-Tokens (nur sichtbar, wenn der API-Zugang aktiviert ist)
(Optional) IP-Whitelisting für zusätzliche Sicherheit – im selben Bereich konfigurierbar

Wenn Sie die Option „API-Tokens“ in Ihrem Konto nicht sehen, wenden Sie sich an den Support, um die Aktivierung des API-Zugangs für Ihren Tarif zu besprechen.

Authentifizierung

Alle API-Anfragen müssen einen Bearer-Token im Authorization-Header enthalten:

Authorization: Bearer YOUR_API_TOKEN

API-Dokumentation

Für die vollständige Endpunktreferenz, Request-/Response-Schemata und Live-„Try it“-Tooling siehe die automatisch generierte Dokumentation:

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

Die Dokumentation umfasst:

Anleitung zur Authentifizierung
Jeden verfügbaren Endpunkt mit Request- und Response-Beispielen
Informationen zur Rate-Begrenzung
Webhook-Konfiguration

Sandbox

LabelGrid bietet eine Sandbox-Umgebung, damit Sie gegen die API entwickeln und testen können, ohne Ihren Produktivkatalog zu beeinträchtigen. Der Sandbox-Zugang erfordert einen aktiven API-Tarif und wird von uns auf Anfrage bereitgestellt – sobald Ihr API-Tarif aktiv ist, wenden Sie sich an den Support, um eine einzurichten. Das Sandbox-IP-Whitelisting konfigurieren wir für Sie; das Produktions-IP-Whitelisting ist im Selbstbedienungsverfahren unter API-Tokens möglich.

Webhooks

Die öffentliche API unterstützt Webhooks für die asynchrone Ereignisbenachrichtigung (Änderungen des Prüfstatus, Auslieferungsaktualisierungen usw.). Siehe Webhooks für die Einrichtung und die verfügbaren Ereignistypen.

Brauchen Sie Hilfe?

Wenn Sie Unterstützung bei der API benötigen, wenden Sie sich an unser Support-Team mit technischen Details zu Ihrer Integration.

Sie nutzen LabelGrid noch nicht?

Alles, was Sie gerade gelesen haben, steht Ihnen auf unserer Plattform zur Verfügung.

Entdecken Sie, was LabelGrid kann →