Preflight QC

Preflight QC is een premium uitbreiding die je professionele release-QC geeft. Dien een release in en Preflight QC analyseert ‘m van begin tot eind: metadata, releasedatums, audio, artwork, AI-content, catalogus-identifiers, eerdere distributie en licentiedocumentatie. Je krijgt een helder, bruikbaar kwaliteitsrapport. Los op wat het aangeeft in je eigen tempo, en bevestig de release voor review wanneer je tevreden bent.

Voor labels en API-integrators werkt Preflight QC als bouwsteen. Haal het kwaliteitsrapport programmatisch op, sluit het aan op je eigen QA-pipeline, laat je interne goedkeuringsproces erop leunen en bevestig releases automatisch voor review. Jouw team bepaalt de kwaliteitslat, Preflight QC doet de analyse.

Een release die schoon binnenkomt, gaat snel door de review. Preflight QC brengt je daar vóór je indient.

Wat Preflight QC is

Met Preflight QC ingeschakeld op je account gaat een voor distributie ingediende release niet meteen de reviewwachtrij in. In plaats daarvan komt de release in een wachtstand vóór de review (“wacht op jouw beoordeling”) terwijl Preflight QC zijn kwaliteitsanalyse uitvoert: metadata, releasedatums, audio, artwork, AI-content, catalogus-identifiers, eerdere distributie en licentiedocumentatie. Het resultaat is een kwaliteitsrapport, en wat je erop bouwt, bepaal je zelf:

• Je eigen QA-workflow (API). Haal je catalogus door de kwaliteitsanalyse, haal het rapport programmatisch op in je eigen QA-pipeline, laat je interne goedkeuringsproces afhangen van de resultaten en bevestig een release pas voor review wanneer die jouw lat haalt. Zie De API gebruiken voor integraties.
• De workflow in de app. Lees het rapport op de releasepagina, los op wat het aangeeft en bevestig wanneer je tevreden bent.

In beide gevallen is het de bevestiging die de release naar de normale reviewwachtrij verplaatst: er gaat niets de review in voordat jij akkoord geeft.

Preflight QC voegt vóór de review een kwaliteitsfase toe. Het verandert niets aan wat er daarna gebeurt: zodra je bevestigt, doorloopt je release hetzelfde validatie- en reviewproces als elke andere release.

Hoe je Preflight QC krijgt

Preflight QC is een premium uitbreiding die ons team per account inschakelt. Om het voor jouw account aan te zetten, neem je contact op met ons salesteam en laat je weten dat je Preflight QC wilt.

Zodra het is ingeschakeld, zie je de nieuwe wacht-en-bevestig-stap de volgende keer dat je een release voor distributie indient.

De Preflight QC-workflow

Dit is het volledige traject van een release met Preflight QC ingeschakeld, van indienen tot review.

1. Dien je release in voor distributie

Maak en voltooi je release zoals gebruikelijk en dien ‘m daarna in voor distributie. Met Preflight QC ingeschakeld zet dit de release niet meteen in de reviewwachtrij. In plaats daarvan gaat de release naar een wachtstand vóór de review en wordt ‘m gemarkeerd als wacht op jouw beoordeling.

2. De kwaliteitsanalyse draait

Terwijl je release in de wachtstand staat, analyseert Preflight QC ‘m van begin tot eind. De analyse dekt:

• Metadata: titels, artiesten, credits en andere gegevens van de release en de tracks
• Releasedatums: je datuminstellingen en releaseversies
• Audio: de audiobestanden die je hebt geüpload
• Artwork: je hoesafbeelding
• AI-content: of het gebruik van AI is opgegeven, en door AI gegenereerde muziek of hoezen die we detecteren
• Catalogus-identifiers: of je ISRC’s geldig zijn en of een opname al door een andere rechthebbende is geclaimd
• Eerdere distributie: of de release of de tracks al via een andere distributeur in de winkels staan
• Licenties: wanneer een cover, een sample of iets vergelijkbaars ondersteunende documentatie nodig heeft

De analyse is meestal een paar minuten na het voltooien van de upload en de transcodering klaar. Terwijl die nog draait, geeft het kwaliteitsrapport aan dat de controles bezig zijn en vermeldt het nog geen problemen.

3. Lees je kwaliteitsrapport

Zodra de analyse klaar is, open je het kwaliteitsrapport van de release om te zien wat, als er iets is, je aandacht nodig heeft. Je kunt het op twee plekken lezen:

• Via de publieke API, voor je eigen QA-pipeline; zie De API gebruiken hieronder.
• In de app, op de releasepagina.

Het rapport toont elk probleem met een duidelijke titel en een bericht dat beschrijft wat je moet oplossen. Zie Het kwaliteitsrapport begrijpen voor hoe je de velden leest.

4. Los op wat wordt gemeld

Werk de problemen in je rapport door:

• Metadataproblemen: pas de gegevens van de release of track aan.
• Audio- of artworkproblemen: vervang het betreffende bestand.
• Problemen die om een reactie vragen: reageer in de notitiethread bij het probleem, of upload het gevraagde document (bijvoorbeeld een licentie voor een cover of sample).

Je release bewerken terwijl ‘m in de wachtstand staat markeert het huidige rapport als verouderd: de bevindingen weerspiegelen niet langer de laatste staat van je release. Bewerk zoveel je wilt en vraag daarna een nieuwe analyse aan, vanaf de releasepagina in de app of via het refresh-endpoint voor integraties. De analyse draait opnieuw en het rapport wordt bijgewerkt met de nieuwe resultaten. Je kunt deze cyclus zo vaak doorlopen als je nodig hebt, binnen een fair-use-limiet op hoeveel nieuwe analyses je per release per uur kunt starten.

5. Bevestig de release

Wanneer je rapport schoon is, of je alles hebt aangepakt wat nodig was, bevestig je de release. In de app is dat een bevestigknop op de release; voor integraties is het het bevestigingsendpoint.

De bevestiging haalt de release uit de wachtstand en verplaatst ‘m naar de normale reviewwachtrij. Bevestigen vereist een voltooide, actuele analyse: als je de release na de laatste run hebt bewerkt, is het rapport verouderd, dus vraag een nieuwe analyse aan en laat die afronden voordat je bevestigt.

6. Normale review

Na bevestiging wordt je release precies zoals elke andere gereviewd. Voor wat er tijdens de review gebeurt, hoe lang het duurt en de mogelijke uitkomsten, zie Validatie en review.

Het kwaliteitsrapport begrijpen

Het kwaliteitsrapport heeft twee delen: een lijst met problemen en een klein blok met rapport-details over de analyserun zelf.

Problemen

Elk probleem in het rapport beschrijft iets om naar te kijken. De velden waarmee je werkt:

Veld	Wat het je vertelt
Titel	Een korte, begrijpelijke naam voor het probleem.
Bericht	Wat het probleem is en wat je eraan moet doen.
Ernst	Hoe belangrijk het probleem is, om je te helpen prioriteren.
Blokkerend	Of het probleem opgelost moet zijn voordat je kunt bevestigen (zie hieronder).
Vereist reactie	Of het probleem een geschreven antwoord of een geüpload document van jou nodig heeft.
Aangepaste beschrijving	Extra details specifiek voor jouw release, wanneer beschikbaar.
Betrokken tracks	Op welke tracks het probleem van toepassing is. Problemen op releaseniveau vermelden geen specifieke tracks.
Bewijs	Bij problemen over datums, duplicaten en eerdere distributie de overeenkomende releases die we vonden, zodat je het conflict zelf kunt controleren (zie hieronder).

Blokkerend of informatief

• Blokkerende problemen moeten opgelost zijn voordat je de release voor review kunt bevestigen. Los op wat ze beschrijven, draai een nieuwe analyse en ze verdwijnen uit je rapport.
• Informatieve problemen staan er om iets aan te geven dat een blik waard is, maar ze houden je niet tegen om te bevestigen. Bekijk ze en bevestig wanneer je klaar bent.

Problemen die een reactie vereisen

Sommige problemen los je niet op met alleen bewerken: ze hebben iets van jou nodig, zoals een geschreven toelichting of een ondersteunend document (bijvoorbeeld een licentie voor een cover of sample). Deze zijn gemarkeerd als vereist reactie. Om er een op te lossen, reageer je in de notitiethread bij het probleem of upload je het gevraagde document voordat je bevestigt.

Bewijs bij een probleem

Sommige problemen bevatten bewijs waarmee je een signaal zonder giswerk kunt controleren: de bestaande releases die we met de jouwe matchten. Je ziet het bij problemen over datums, duplicaten en eerdere distributie. Elke match toont de titel en artiest van de overeenkomende track, de bijbehorende releasetitel, releasedatum en ISRC, plus een link naar een store waar die release live staat, en welke van jouw tracks het raakt. Er worden maximaal drie matches per track vermeld. Gebruik het bewijs om te bevestigen of het conflict echt is (bijvoorbeeld een eerdere upload van jezelf) voordat je beslist hoe je reageert.

De rapportdetails

Naast de problemen bevat het rapport enkele details over de analyserun:

Veld	Wat het je vertelt
generated_at	Wanneer het huidige rapport is gemaakt. Dit is leeg zolang de eerste analyse nog draait.
checks_in_progress	true zolang de analyse nog draait; de probleemlijst blijft leeg totdat die klaar is.
stale	true wanneer je de release (of een van de tracks) hebt bewerkt na de laatste voltooide analyse, waardoor de bevindingen niet langer de huidige staat weerspiegelen. Elke bewerking telt. Vraag een nieuwe analyse aan om het rapport bij te werken.
hold	Of de release momenteel in de wachtstand vóór de review staat.
review_status	De huidige reviewstatus van de release.
release_status	De algehele status van de release zelf, naast de reviewspecifieke status.
profile	Het kwaliteitsprofiel dat op deze release is toegepast, met zijn naam en versie.

De API gebruiken voor integraties

Als je bouwt op de publieke LabelGrid-API, kun je Preflight QC aansluiten op je eigen pipeline: haal elke release door de kwaliteitsanalyse, haal het rapport op in je eigen QA-workflow, laat je interne goedkeuringsproces ervan afhangen en bevestig voor review vanuit je eigen tooling. Preflight QC biedt hiervoor drie endpoints, alle met dezelfde Bearer-token-authenticatie als de rest van de publieke API. Voor de volledige, altijd actuele request- en response-schema’s, zie de API-referentie.

Webhook: weet wanneer het rapport klaar is

In plaats van te pollen voor resultaten kun je LabelGrid je laten vertellen zodra een rapport klaar is. Abonneer je op het webhook-event release.preflight.report_ready: het wordt geactiveerd zodra Preflight QC klaar is met het analyseren van een release in de wachtstand vóór de review, ook telkens wanneer een heranalyse die je aanvraagt is voltooid. Je krijgt precies één event per analysecyclus.

Abonneer je er op dezelfde manier op als op de andere release-webhook-events van LabelGrid, vanuit je webhook-instellingen in de app of via de API. Elk event bevat een compacte samenvatting van de run, nooit de problemen zelf:

• Release-identifiers: release_id, label_id, release_cat en release_title.
• generated_at: wanneer dit rapport is gemaakt. Het komt overeen met de eigen generated_at van het rapport.
• profile: het kwaliteitsprofiel waarmee de aantallen zijn berekend, als {name, version}.
• counts: de totalen voor blocking, informational en requires_feedback. De telling van requires_feedback overlapt de andere twee.

Gebruik de aantallen om te beslissen of je moet handelen, en haal dan het rapport zelf op voor de details. Het aanbevolen integratiepatroon:

1. Abonneer je op release.preflight.report_ready.
2. Bij elk event roep je Het kwaliteitsrapport ophalen aan om de volledige set problemen te lezen.
3. Los op en draai opnieuw: nadat je een release in de wachtstand hebt bewerkt, roep je het refresh-endpoint aan om een nieuwe analyse te starten; de webhook wordt opnieuw geactiveerd wanneer die is voltooid.
4. Beslis en bevestig vanuit je eigen tooling zodra de release jouw lat haalt.

Voor de volledige payload-referentie en webhook-mechanismen (ondertekening, herhaalpogingen en de envelop), zie Webhooks.

Het kwaliteitsrapport ophalen

GET /api/public/releases/{id}/quality-report
Authorization: Bearer YOUR_API_TOKEN

Geeft het huidige kwaliteitsrapport van de release terug. De response bevat:

• issues[]: één item per probleem, elk met id, code (een stabiele string; zie Werken met probleemcodes), title, message, status, severity, is_blocking, requires_feedback, custom_description en affected_tracks. Bij problemen over datums, duplicaten en eerdere distributie bevat het item ook een evidence-array (zie hieronder).
• report: generated_at, checks_in_progress, stale, hold, review_status, release_status en profile (een object met name en version). stale is true wanneer de release of een van de tracks is bewerkt na de laatste voltooide analyse; draai de analyse opnieuw met het refresh-endpoint voordat je bevestigt.

Zolang de analyse nog draait, geeft het rapport checks_in_progress: true terug met een lege issues-lijst. Als je liever geen webhooks gebruikt, poll je dit endpoint totdat generated_at is ingesteld, meestal een paar minuten nadat de upload en transcodering klaar zijn, en lees je dan de problemen. Om in plaats daarvan meteen te horen dat het rapport klaar is, gebruik je de report-ready-webhook.

Een voorbeeldresponse zodra de analyse klaar is:

{
  "issues": [
    {
      "id": "12345",
      "code": "example.issue-code",
      "title": "Short issue title",
      "message": "What to fix and how.",
      "status": "confirmed",
      "severity": "…",
      "is_blocking": true,
      "requires_feedback": false,
      "custom_description": null,
      "affected_tracks": [456],
      "evidence": [
        {
          "affected_track_id": 456,
          "track_title": "Matched track title",
          "artist": "Matched artist",
          "release_title": "Matched release",
          "release_date": "2024-03-01",
          "isrc": "USRC12345678",
          "store_url": "https://…"
        }
      ]
    }
  ],
  "report": {
    "generated_at": "2026-07-07T12:00:00Z",
    "checks_in_progress": false,
    "stale": false,
    "hold": true,
    "review_status": "…",
    "release_status": "…",
    "profile": { "name": "quality_report", "version": 2 }
  }
}

Elk evidence-item beschrijft één bestaande release die met de jouwe overeenkwam: affected_track_id (op welke van jouw tracks de match van toepassing is), de overeenkomende track_title, artist, release_title, release_date en isrc, en een store_url die verwijst naar een storepagina waar de match live staat. Er worden hoogstens drie matches per track vermeld, en de sleutel is alleen aanwezig bij de bovenstaande probleemsoorten.

Een nieuwe analyse aanvragen

POST /api/public/releases/{id}/quality-report/refresh
Authorization: Bearer YOUR_API_TOKEN

Start een nieuwe Preflight QC-analysecyclus voor een release in de wachtstand. Een release in de wachtstand bewerken draait de controles niet vanzelf opnieuw: het markeert alleen het huidige rapport als verouderd (report.stale: true). Wanneer je klaar bent met bewerken, roep je dit endpoint aan om de analyse opnieuw te draaien; wanneer de cyclus is voltooid, wordt de report-ready-webhook geactiveerd en keert report.stale terug naar false.

Een geslaagde aanroep geeft 202 Accepted terug:

{
  "status": "refreshing",
  "checks_in_progress": true,
  "review_status": "pending_customer_review",
  "release_status": "to_review"
}

De aanroep is idempotent zolang een cyclus draait: ‘m opnieuw aanroepen geeft dezelfde in-progress body terug, zet geen tweede analyse in de wachtrij en telt niet mee voor je budget. Andere responses die je moet afhandelen:

• 409 not_in_customer_review_hold: de release staat momenteel niet in de wachtstand voor jouw Preflight QC-review.
• 409 refresh_coalesced: een analyse voor deze release is zojuist voltooid, dus er is niets in de wachtrij gezet. Probeer het opnieuw na de Retry-After-header (seconden).
• 429 preflight_recheck_limit_reached: je hebt het fair-use-budget van 6 gestarte analysecycli per release per voortschrijdend uur bereikt. De Retry-After-header (seconden) vertelt je wanneer de volgende verversing is toegestaan. Een lopende analyse pollen is gratis; alleen het starten van een nieuwe cyclus verbruikt budget.
• 403 RELEASE_NOT_VALIDATED: de release moet de validatie doorstaan voordat een heranalyse kan starten (dezelfde regel als bij distribueren); draai eerst de validatie.
• 403 pre_review_qc_not_enabled: Preflight QC is niet ingeschakeld voor het eigenaarsaccount.

De release voor review bevestigen

POST /api/public/releases/{id}/confirm-review
Authorization: Bearer YOUR_API_TOKEN

Haalt de release uit de wachtstand en verplaatst ‘m naar de normale reviewwachtrij: het API-equivalent van de bevestigknop in de app.

Bevestigen vereist een voltooide, actuele analyse. Twee conflicten om af te handelen:

• 409 checks_in_progress: de analyse draait nog. Wacht op de report-ready-webhook (of poll totdat generated_at is ingesteld) en probeer het dan opnieuw.
• 409 checks_stale: de release is bewerkt na de laatste voltooide analyse (report.stale is true). Roep het refresh-endpoint aan, wacht op het nieuwe rapport en probeer de bevestiging dan opnieuw.

Opmerking

Zolang een release in de wachtstand vóór de review staat, geeft ‘m indienen via het normale distributiepad 409 preflight_recheck_required terug: een release in de wachtstand verlaat die alleen via het hier beschreven verversen-en-bevestigen-proces.

Werken met probleemcodes

Bouw je logica op het kwaliteitsrapport, baseer die dan op de code van het probleem:

• code is een stabiele string in slug-formaat (bijvoorbeeld audio.trailing-silence). Je kunt codes veilig in je systeem mappen en er logica op bouwen.
• Titels en berichten zijn teksten voor mensen. Ze kunnen in de loop van de tijd worden bijgeschaafd; baseer je logica dus nooit op de tekst en gebruik die alleen voor weergave.
• Er kunnen nieuwe codes bijkomen naarmate de dekking van Preflight QC uitbreidt. Behandel onbekende codes generiek: toon de title en message uit de payload in plaats van te falen.
• Je rapporten leren je welke codes ertoe doen. Terwijl je releases door Preflight QC haalt, duiken de codes die voor jouw catalogus relevant zijn vanzelf op in je eigen kwaliteitsrapporten.
• Wat de analyse dekt. Problemen vallen in deze categorieën: release- en trackmetadata, releasedatums en -versies, audiokwaliteit, artwork, AI-content, catalogus-identifiers, eerdere distributie, en licenties en documentatie.

De probleemcatalogus

Om problemen te mappen bij het bouwen van je eigen QA-workflow, haal je de volledige catalogus programmatisch op:

GET /api/public/issue-definitions
Authorization: Bearer YOUR_API_TOKEN

Dit geeft elk probleem terug dat in een kwaliteitsrapport kan verschijnen, gesleuteld op de stabiele stringcode, met de titel, het berichtsjabloon, de ernst, de blokkerend-vlag, requires_feedback en de categorie (type). De response bevat ook het kwaliteitsprofiel waarmee de catalogus is berekend, als {name, version}. Het endpoint is alleen beschikbaar voor accounts met de Preflight QC-uitbreiding.

Veelgestelde vragen

Wat als de analyse nog draait?

Het rapport toont checks_in_progress: true zonder dat er al problemen worden vermeld. Dat is normaal net na het indienen. Wacht een paar minuten nadat de upload en transcodering klaar zijn en kijk dan opnieuw: in de app werkt het rapport zichzelf bij. Via de API kun je je abonneren op de report-ready-webhook om op het moment dat het klaar is een melding gepusht te krijgen, of pollen totdat generated_at is ingesteld.

Kan ik mijn release bewerken terwijl ‘m in de wachtstand staat?

Ja, bewerk zo vrij als je wilt: een release in de wachtstand vóór de review blijft volledig bewerkbaar. Bewerken draait de controles niet vanzelf opnieuw; het markeert het huidige rapport als verouderd. Wanneer je klaar bent met je wijzigingen, vraag je een nieuwe analyse aan (vanaf de releasepagina in de app, of via het refresh-endpoint voor integraties) om de bijgewerkte resultaten te zien zonder de wachtstand te verlaten. De nieuwe analyse moet voltooid zijn voordat je kunt bevestigen.

Wat gebeurt er nadat ik bevestig?

Je release verlaat de wachtstand en komt in de normale reviewwachtrij, waar ‘m net als elke andere wordt gereviewd. Zie Validatie en review voor hoe de review werkt, hoe lang die duurt en de mogelijke uitkomsten.

Kan ik een release terugzetten naar concept?

Ja: zolang je release in de wachtstand vóór de review staat en je ‘m nog niet hebt bevestigd, is ‘m niet in review gegaan, dus je kunt ‘m gerust blijven bewerken of als concept laten staan en er later op terugkomen. De release komt pas in de reviewwachtrij wanneer je ‘m bevestigt.

Moet ik elk probleem oplossen voordat ik bevestig?

Je moet blokkerende problemen oplossen voordat je kunt bevestigen. Informatieve problemen houden je niet tegen om te bevestigen, maar zijn een blik waard: zoveel mogelijk opschonen vóór de review is de snelste weg naar goedkeuring.

---

Vragen over Preflight QC? Neem contact op met ons team. We helpen je graag.