Gids voor bulkupload

Voor labels met grote catalogi besparen bulkuploadtools veel tijd. LabelGrid ondersteunt twee methoden om meerdere releases te uploaden: API-integratie en DDEX-import.

Methoden voor bulkupload

Beschikbare opties

Methode	Geschikt voor	Vereist abonnement
API-integratie	Geautomatiseerde workflows, maatwerkintegraties	Abonnementen met API-toegang ingeschakeld
DDEX-import	Standaardfeeds uit de sector, workflows van grote labels	Enterprise- / API-abonnementen (neem contact op met support)

Opmerking

Bulkuploadmethoden zijn beschikbaar bij abonnementen met API-toegang ingeschakeld. Als je abonnement geen API-toegang bevat, kun je releases afzonderlijk aanmaken via het LabelGrid-dashboard of contact opnemen met support om API-toegang te bespreken.

---

API-integratie

Overzicht

Met de LabelGrid-API kun je releases programmatisch aanmaken en beheren, waardoor volledig geautomatiseerde workflows voor grote catalogi mogelijk worden.

Wat je kunt doen

• Releases programmatisch aanmaken
• Audiobestanden uploaden via de API
• Metadata in bulk beheren
• Distributieworkflows automatiseren
• Integreren met je bestaande systemen

Aan de slag

1. Schakel API-toegang in op je abonnement - neem contact op met support als die nog niet is ingeschakeld
2. Genereer API-inloggegevens in je accountinstellingen
3. Bekijk de API-documentatie voor de details van de endpoints
4. Bouw je integratie of gebruik onze SDK’s
5. Test met de staging-omgeving voordat je in productie gaat

Voorbeeldverzoek

POST /api/public/releases
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY

{
  "title": "Album Title",
  "type": "album",
  "primary_artist": "Artist Name",
  "release_date": "2024-03-15",
  "tracks": [
    {
      "title": "Track One",
      "track_number": 1,
      "isrc": "USRC12400001"
    }
  ]
}

Je vorige distributeur vastleggen

Wanneer je releases overzet die al elders live staan, accepteert de openbare Releases-API een optioneel veld transfer_from_distributor (vrije tekst, maximaal 255 tekens) om de distributeur vast te leggen waar je vandaan komt. Dat veld wordt alleen-lezen zodra de release is gedistribueerd, dus vul het in vóór of bij het indienen.

Voordelen van de API

• Volledige automatisering - Geen handmatige tussenkomst nodig
• Systeemintegratie - Koppel met je DAM, CRM of andere tools
• Geplande releases - Zet releases in de wachtrij voor toekomstige distributie
• Validatie op maat - Controleer content vooraf voordat je hem indient
• Webhook-meldingen - Ontvang realtime-updates over de leveringsstatus
• Foutafhandeling - Programmatische foutdetectie en opnieuw proberen

Rate limits

De API hanteert rate limits voor de stabiliteit van het systeem. Zie het API-overzicht voor de actuele details over rate limits.

Zie het API-overzicht voor de volledige documentatie.

---

DDEX-import

Overzicht

DDEX (Digital Data Exchange) is het standaardformaat in de sector dat grote labels gebruiken om content aan distributeurs te leveren. LabelGrid ondersteunt DDEX-import voor enterpriseklanten die al een DDEX-leveringsinfrastructuur hebben.

Wat is DDEX?

DDEX is een op XML gebaseerde standaard die het volgende bundelt:

• Releasemetadata
• Trackinformatie
• Verwijzingen naar audiobestanden
• Artwork en assets
• Dealvoorwaarden en territoria

Ondersteunde formaten

Versie	Status
ERN 4.3.2	Ondersteund (aanbevolen)
ERN 4.3.1	Ondersteund
ERN 4.3.0	Ondersteund
ERN 3.8.2	Ondersteund (legacy)

DDEX-installatieproces

1. Neem contact op met support om DDEX in te schakelen
2. Doorloop de onboarding met ons technische team
3. Configureer de leveringsinstellingen en bestandspaden
4. Stel SFTP-inloggegevens in voor een beveiligde bestandsoverdracht
5. Verstuur een testlevering ter validatie
6. Begin met productieleveringen zodra je bent goedgekeurd

Leveringsworkflow

Your System → DDEX XML + Assets → SFTP Upload → LabelGrid Processing → Distribution

DDEX-vereisten

Vereiste	Details
Abonnement	API-toegang ingeschakeld (neem contact op met support)
Formaat	ERN 4.3.2 heeft de voorkeur (4.3.1, 4.3.0 en 3.8.2 worden ook ondersteund)
Levering	Alleen SFTP
Assets	Audiobestanden meegeleverd of via verwijzing
Validatie	Pre-flight-validatie aanbevolen

Wanneer DDEX gebruiken

DDEX-import is ideaal als:

• Je al een DDEX-leveringsinfrastructuur hebt
• Je overstapt van een andere distributeur die DDEX gebruikt
• Je contentmanagementsysteem standaard DDEX exporteert
• Je een groot label bent of een grote onafhankelijke partij met gevestigde workflows

Wanneer je beter de API gebruikt

De REST/JSON-API is beter als:

• Je een nieuwe integratie helemaal opnieuw bouwt
• Je moderne web-API’s verkiest boven XML
• Je realtime tweerichtingscommunicatie nodig hebt
• Je meldingen op basis van webhooks wilt

---

De juiste methode kiezen

Factor	API-integratie	DDEX-import
Complexiteit van de installatie	Lager	Hoger
Bestaande infrastructuur	Nieuw bouwen	Bestaande DDEX gebruiken
Formaat	JSON	XML
Leveringsmethode	HTTPS	SFTP
Realtime-updates	Ja (webhooks)	Polling vereist
Geschikt voor	Nieuwe integraties	Enterprisemigratie

---

Verwerkingstijden

Zodra content is geüpload via de API of DDEX, hangt de verwerkingstijd af van:

• Het aantal releases en tracks
• De grootte van de audiobestanden
• De complexiteit van de metadata
• De huidige belasting van het systeem

Grotere catalogi hebben uiteraard meer verwerkingstijd nodig. Neem contact op met support als je advies wilt over de verwachte doorlooptijden voor jouw specifieke catalogusgrootte.

---

Limieten voor indiening bij grote migraties

Op je account kan een voortschrijdende limiet van 7 dagen voor het indienen van releases gelden. Wanneer die actief is, telt elke release-indiening op je account mee, inclusief releases die via de API en via DDEX-imports zijn ingediend. Een release opnieuw indienen telt eveneens mee.

Plan je een grote eenmalige catalogusmigratie en verwacht je meer dan 20 releases in een week in te dienen? Behandel dat dan als een begeleide activiteit: neem eerst contact op met support zodat we het samen met je kunnen plannen. Support kan voor een migratie een tijdelijk uitzonderingsvenster instellen, dus neem contact op voordat je begint met uploaden in plaats van halverwege je migratie tegen de limiet aan te lopen.

Controleer of alle tracks zijn ingelezen

Bevestig na een bulk- of DDEX-import dat elke track correct is geïmporteerd voordat je gaat distribueren.

---

Gerelateerd

Beheer je een grote catalogus? Bekijk dan catalogusbeheer op onze website voor hoe LabelGrid je releases ook op grote schaal georganiseerd houdt.

---

Hulp nodig?

Voor hulp bij het instellen van bulkupload:

• API-integratie: Bekijk het API-overzicht of neem contact op met support
• DDEX inschakelen: Neem contact op met ons supportteam en geef je vereisten door

Ons team helpt je de juiste methode te kiezen en begeleidt je bij de installatie.