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 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 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
• 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 laat de betreffende delen van de analyse opnieuw draaien, en het rapport wordt bijgewerkt met de nieuwe resultaten. Je kunt deze cyclus zo vaak doorlopen als nodig is.

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. Voor bevestigen moet de analyse klaar zijn: als je de release na de laatste run hebt bewerkt, wacht dan op het bijgewerkte rapport 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.

Blokkerend of informatief

• Blokkerende problemen moeten opgelost zijn voordat je de release voor review kunt bevestigen. Los op wat ze beschrijven, laat de analyse opnieuw draaien 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.

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.
hold	Of de release momenteel in de wachtstand vóór de review staat.
review_status	De huidige reviewstatus van de release.
profile	Het kwaliteitsprofiel dat op deze release is toegepast.

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 twee endpoints, beide 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.

Het kwaliteitsrapport ophalen

GET /v4/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 code (een stabiele string; zie Werken met probleemcodes), title, message, severity, is_blocking, requires_feedback, custom_description en affected_tracks.
• report: generated_at, checks_in_progress, hold, review_status en profile.

Zolang de analyse nog draait, geeft het rapport checks_in_progress: true terug met een lege issues-lijst. Poll het endpoint totdat generated_at is ingesteld, meestal een paar minuten nadat de upload en transcodering klaar zijn, en lees dan de problemen.

Een voorbeeldresponse zodra de analyse klaar is:

{
  "issues": [
    {
      "code": "example.issue-code",
      "title": "Short issue title",
      "message": "What to fix and how.",
      "severity": "…",
      "is_blocking": true,
      "requires_feedback": false,
      "custom_description": null,
      "affected_tracks": [456]
    }
  ],
  "report": {
    "generated_at": "2026-07-07T12:00:00Z",
    "checks_in_progress": false,
    "hold": true,
    "review_status": "…",
    "profile": "…"
  }
}

De release voor review bevestigen

POST /v4/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.

Voor bevestigen moet de analyse klaar zijn. Als de release na de laatste analyserun is bewerkt, wordt het rapport opnieuw gegenereerd en geeft het endpoint een conflict terug. Haal in dat geval het kwaliteitsrapport opnieuw op, wacht tot generated_at weer is ingesteld en probeer de bevestiging opnieuw.

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, 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 /v4/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 en requires_feedback. 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 en via de API kun je het pollen totdat generated_at is ingesteld.

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

Ja. Een release bewerken in de wachtstand vóór de review laat de betreffende delen van de analyse opnieuw draaien en werkt het rapport bij, dus je kunt problemen oplossen en de bijgewerkte resultaten zien zonder de wachtstand te verlaten. Onthoud alleen dat je na een bewerking moet wachten op het bijgewerkte rapport 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.