API-overzicht

Met de openbare LabelGrid API kunnen ontwikkelaars programmatisch met LabelGrid werken: je catalogus uitlezen, releases aanmaken en bijwerken, bestanden uploaden en releases aanbieden voor distributie.

Wat de API biedt

De openbare API draait onder /api/public/... op api.labelgrid.com en geeft programmatische toegang tot:

• Releases: opvragen, aanmaken, bijwerken, verwijderen; artwork uploaden; valideren; aanbieden voor distributie
• Tracks: opvragen, aanmaken, bijwerken; audiobestanden uploaden; tracklicenties beheren
• Labels: je labelprofielen opvragen en beheren
• Artiesten: artiestprofielen opvragen en beheren
• Schrijvers en bijdragers: profielen van schrijvers/bijdragers opvragen en beheren
• Uitgevers: uitgeversprofielen opvragen en beheren
• Webhooks: webhook-endpoints registreren voor asynchrone meldingen
• Referentiegegevens: genres, talen, bijdragerrollen, instrumenten, distributiegebieden, distro-outlets

Veelvoorkomende toepassingen

• Releases automatisch aanmaken vanuit je bestaande systemen
• Catalogusgegevens synchroniseren met je eigen database
• Eigen dashboards en rapportagetools bouwen
• Koppelen aan de workflowtools die je al gebruikt
• White-labeldistributiediensten draaien bovenop LabelGrid

---

API-toegang aanvragen

Om de LabelGrid API te gebruiken heb je nodig:

1. Een LabelGrid-account met API-toegang ingeschakeld op het abonnement
2. Een API-token dat je aanmaakt in je accountinstellingen: open het avatarmenu rechtsboven en klik op API Tokens (alleen zichtbaar als API-toegang is ingeschakeld)
3. (Optioneel) IP-whitelisting voor extra beveiliging, in te stellen op dezelfde plek

Zie je de optie API Tokens niet in je account, neem dan contact op met support om API-toegang op je abonnement te bespreken.

---

Authenticatie

Elke API-aanvraag moet een Bearer-token bevatten in de Authorization-header:

Authorization: Bearer YOUR_API_TOKEN

---

API-documentatie

Voor de volledige endpointreferentie, request/response-schema’s en live “try it”-tooling kun je terecht in de automatisch gegenereerde documentatie:

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

De documentatie omvat:

• Een handleiding voor authenticatie
• Elk beschikbaar endpoint, met voorbeelden van request en response
• Informatie over rate limiting
• Webhook-configuratie

---

Sandbox

LabelGrid biedt een sandboxomgeving waarin je kunt bouwen en testen tegen de API zonder je productiecatalogus te raken. Sandboxaccounts worden op aanvraag aangemaakt. Neem contact op met support om er een te laten inrichten.

---

Webhooks

De openbare API ondersteunt webhooks voor asynchrone gebeurtenismeldingen (wijzigingen in de reviewstatus, leveringsupdates, enzovoort). Zie Webhooks voor het instellen en de beschikbare gebeurtenistypen.

---

Gerelateerd

Bouw je op de LabelGrid API? Bekijk de ontwikkelaarshub voor een overzicht van wat er mogelijk is. Draai je een white-labeldistributiedienst bovenop LabelGrid, dan schetst de pagina infrastructuur voor distributeurs het grotere geheel.

---

Hulp nodig?

Heb je API-hulp nodig, neem dan contact op met ons supportteam met technische details over je integratie.