Preflight QC

Preflight QC är ett premiumtillägg som ger dig professionell release-QC. Skicka in en release så analyserar Preflight QC den från början till slut: metadata, releasedatum, ljud, omslag och licensdokumentation. Du får en tydlig, användbar kvalitetsrapport. Åtgärda det den flaggar i din egen takt och bekräfta sedan releasen för granskning när du är nöjd.

För bolag och API-integratörer fungerar Preflight QC som en byggsten. Hämta kvalitetsrapporten programmatiskt, koppla in den i din egen QA-pipeline, låt din interna godkännandeprocess styras av den och bekräfta releaser för granskning automatiskt. Ditt team sätter kvalitetsribban, och Preflight QC gör analysen.

En release som kommer in ren går snabbt genom granskningen. Preflight QC tar dig dit innan du skickar in.

Vad Preflight QC är

Med Preflight QC aktiverat på ditt konto går en release som skickas in för distribution inte direkt in i granskningskön. I stället hamnar releasen i ett vänteläge före granskning (“väntar på din genomgång”) medan Preflight QC gör sin kvalitetsanalys: metadata, releasedatum, ljud, omslag och licensdokumentation. Resultatet är en kvalitetsrapport, och vad du bygger på den är upp till dig:

• Ditt eget QA-flöde (API). Kör din katalog genom kvalitetsanalysen, hämta rapporten programmatiskt i din egen QA-pipeline, låt din interna godkännandeprocess styras av resultaten och bekräfta varje release för granskning först när den klarar din ribba. Se Använda API:et för integrationer.
• Flödet i appen. Läs rapporten på releasesidan, åtgärda det den flaggar och bekräfta när du är nöjd.

I båda fallen är det bekräftelsen som flyttar releasen till den vanliga granskningskön: inget går in i granskning förrän du gett klartecken.

Preflight QC lägger till ett kvalitetssteg före granskningen. Det ändrar inget i vad som händer efteråt: så snart du bekräftar går din release genom samma validerings- och granskningsprocess som vilken annan release som helst.

Så får du Preflight QC

Preflight QC är ett premiumtillägg som vårt team aktiverar per konto. För att slå på det för ditt konto, kontakta vårt säljteam och meddela att du vill ha Preflight QC.

När det är aktiverat ser du det nya vänte- och bekräftelsesteget nästa gång du skickar in en release för distribution.

Arbetsflödet i Preflight QC

Här är hela resan för en release med Preflight QC aktiverat, från insändning till granskning.

1. Skicka in din release för distribution

Skapa och färdigställ din release som vanligt och skicka sedan in den för distribution. Med Preflight QC aktiverat placerar detta inte releasen i granskningskön direkt. I stället går releasen till ett vänteläge före granskning och markeras som väntar på din genomgång.

2. Kvalitetsanalysen körs

Medan din release är i vänteläge analyserar Preflight QC den från början till slut. Analysen täcker:

• Metadata: titlar, artister, medverkande och andra uppgifter om releasen och spåren
• Releasedatum: dina datuminställningar och releaseversioner
• Ljud: de ljudfiler du har laddat upp
• Omslag: din omslagsbild
• Licenser: när en cover, ett sample eller liknande behöver styrkande dokumentation

Analysen är oftast klar någon minut efter att uppladdningen och transkodningen har slutförts. Medan den fortfarande pågår anger kvalitetsrapporten att kontrollerna pågår och listar ännu inga problem.

3. Läs din kvalitetsrapport

När analysen är klar öppnar du releasens kvalitetsrapport för att se vad som, om något, behöver din uppmärksamhet. Du kan läsa den på två ställen:

• Via det publika API:et, för din egen QA-pipeline; se Använda API:et nedan.
• I appen, på releasesidan.

Rapporten listar varje problem med en tydlig titel och ett meddelande som beskriver vad som ska åtgärdas. Se Förstå kvalitetsrapporten för hur du läser fälten.

4. Åtgärda det som flaggas

Gå igenom problemen i din rapport:

• Metadataproblem: redigera uppgifterna för releasen eller spåret.
• Ljud- eller omslagsproblem: byt ut den berörda filen.
• Problem som ber om återkoppling: svara i problemets anteckningstråd, eller ladda upp det begärda dokumentet (till exempel en licens för en cover eller ett sample).

Att redigera din release medan den är i vänteläge kör om de berörda delarna av analysen, och rapporten uppdateras med de nya resultaten. Du kan gå detta varv så många gånger du behöver.

5. Bekräfta releasen

När din rapport är ren, eller du har åtgärdat allt du behövde, bekräftar du releasen. I appen är det en bekräfta-knapp på releasen; för integrationer är det bekräftelse-endpointen.

Bekräftelsen tar releasen ur väntläget och flyttar den till den vanliga granskningskön. Bekräftelse kräver att analysen är klar: om du har redigerat releasen efter den senaste körningen, vänta på den uppdaterade rapporten innan du bekräftar.

6. Vanlig granskning

Efter bekräftelsen granskas din release precis som vilken annan som helst. För vad som händer under granskningen, hur lång tid den tar och de möjliga utfallen, se Validering och granskning.

Förstå kvalitetsrapporten

Kvalitetsrapporten har två delar: en lista med problem och ett litet block med rapport-detaljer om analyskörningen.

Problem

Varje problem i rapporten beskriver något att titta på. Fälten du kommer att arbeta med:

Fält	Vad det säger dig
Titel	Ett kort, lättbegripligt namn på problemet.
Meddelande	Vad problemet är och vad du ska göra åt det.
Allvarlighetsgrad	Hur viktigt problemet är, för att hjälpa dig prioritera.
Blockerande	Om problemet måste lösas innan du kan bekräfta (se nedan).
Kräver återkoppling	Om problemet behöver ett skriftligt svar eller ett uppladdat dokument från dig.
Anpassad beskrivning	Extra detaljer som är specifika för din release, när sådana finns.
Berörda spår	Vilka spår problemet gäller. Problem på releasenivå listar inga specifika spår.

Blockerande eller informativt

• Blockerande problem måste lösas innan du kan bekräfta releasen för granskning. Åtgärda det de beskriver, låt analysen köras om, så försvinner de från din rapport.
• Informativa problem finns där för att flagga något som är värt en titt, men de hindrar dig inte från att bekräfta. Titta igenom dem och bekräfta när du är redo.

Problem som kräver återkoppling

Vissa problem går inte att lösa enbart genom att redigera: de behöver något från dig, som en skriftlig förklaring eller ett styrkande dokument (till exempel en licens för en cover eller ett sample). De är markerade som kräver återkoppling. För att lösa ett sådant, svara i problemets anteckningstråd eller ladda upp det begärda dokumentet innan du bekräftar.

Rapportdetaljerna

Vid sidan av problemen innehåller rapporten några detaljer om analyskörningen:

Fält	Vad det säger dig
generated_at	När den aktuella rapporten togs fram. Det är tomt medan den första analysen fortfarande pågår.
checks_in_progress	true medan analysen fortfarande pågår; problemlistan är tom tills den är klar.
hold	Om releasen just nu är i väntläget före granskning.
review_status	Releasens aktuella granskningsstatus.
profile	Den kvalitetsprofil som tillämpas på den här releasen.

Använda API:et för integrationer

Om du bygger på LabelGrids publika API kan du koppla in Preflight QC i din egen pipeline: kör varje release genom kvalitetsanalysen, hämta rapporten i ditt eget QA-flöde, låt din interna godkännandeprocess styras av den och bekräfta för granskning från dina egna verktyg. Preflight QC tillhandahåller två endpoints för detta, båda med samma Bearer-token-autentisering som resten av det publika API:et. För de fullständiga och alltid aktuella request- och response-scheman, se API-referensen.

Hämta kvalitetsrapporten

GET /v4/public/releaser/{id}/quality-report
Authorization: Bearer YOUR_API_TOKEN

Returnerar releasens aktuella kvalitetsrapport. Svaret innehåller:

• issues[]: en post per problem, var och en med code (en stabil sträng; se Arbeta med problemkoder), title, message, severity, is_blocking, requires_feedback, custom_description och affected_tracks.
• report: generated_at, checks_in_progress, hold, review_status och profile.

Medan analysen fortfarande pågår returnerar rapporten checks_in_progress: true med en tom issues-lista. Polla endpointen tills generated_at är satt, vanligtvis någon minut efter att uppladdningen och transkodningen är klara, och läs sedan problemen.

Ett exempelsvar när analysen är klar:

{
  "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": "…"
  }
}

Bekräfta releasen för granskning

POST /v4/public/releaser/{id}/confirm-review
Authorization: Bearer YOUR_API_TOKEN

Tar releasen ur väntläget och flyttar den till den vanliga granskningskön: API-motsvarigheten till bekräfta-knappen i appen.

Bekräftelse kräver att analysen är klar. Om releasen redigerades efter den senaste analyskörningen håller rapporten på att genereras om, och endpointen returnerar en konflikt. När det händer, hämta kvalitetsrapporten på nytt, vänta tills generated_at är satt igen och försök bekräfta på nytt.

Arbeta med problemkoder

Om du bygger logik ovanpå kvalitetsrapporten, basera den på problemets code:

• code är en stabil sträng i slug-format (till exempel audio.trailing-silence). Du kan tryggt mappa koderna i ditt system och bygga logik på dem.
• Titlar och meddelanden är texter för människor. De kan finslipas över tid, så basera aldrig din logik på texten; använd den bara för visning.
• Nya koder kan tillkomma i takt med att Preflight QC:s täckning utökas. Hantera okända koder generiskt: visa title och message från svaret i stället för att fallera.
• Dina rapporter lär dig vilka koder som räknas. I takt med att du kör releaser genom Preflight QC dyker de koder som är relevanta för din katalog upp naturligt i dina egna kvalitetsrapporter.
• Vad analysen täcker. Problemen faller inom dessa kategorier: release- och spårmetadata, releasedatum och versioner, ljudkvalitet, omslag samt licenser och dokumentation.

Problemkatalogen

För att mappa problemen när du bygger ditt eget QA-flöde, hämta hela katalogen programmatiskt:

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

Den returnerar varje problem som kan dyka upp i en kvalitetsrapport, nycklat på sin stabila strängkod, med titel, meddelandemall, allvarlighetsgrad, blockeringsflagga och requires_feedback. Endpointen är bara tillgänglig för konton med Preflight QC-tillägget.

Vanliga frågor

Vad händer om analysen fortfarande pågår?

Rapporten visar checks_in_progress: true utan några problem listade ännu. Det är normalt precis efter att du skickat in. Vänta någon minut efter att uppladdningen och transkodningen är klara och titta sedan igen: i appen uppdateras rapporten av sig själv, och via API:et kan du polla den tills generated_at är satt.

Kan jag redigera min release medan den är i väntläge?

Ja. Att redigera en release i väntläget före granskning kör om de berörda delarna av analysen och uppdaterar rapporten, så du kan åtgärda problem och se de uppdaterade resultaten utan att lämna väntläget. Kom bara ihåg att du efter en redigering måste vänta på den uppdaterade rapporten innan du kan bekräfta.

Vad händer efter att jag bekräftat?

Din release lämnar väntläget och ansluter sig till den vanliga granskningskön, där den granskas som vilken annan som helst. Se Validering och granskning för hur granskningen fungerar, hur lång tid den tar och de möjliga utfallen.

Kan jag ta tillbaka en release till utkast?

Ja: så länge din release är i väntläget före granskning och du inte har bekräftat den ännu har den inte gått in i granskning, så du är fri att fortsätta redigera den eller lämna den som utkast och återkomma senare. Den går in i granskningskön först när du bekräftar den.

Måste jag åtgärda varje problem innan jag bekräftar?

Du måste lösa blockerande problem innan du kan bekräfta. Informativa problem hindrar dig inte från att bekräfta, men de är värda en titt: att röja undan så mycket som möjligt före granskningen är den snabbaste vägen till godkännande.

---

Frågor om Preflight QC? Kontakta vårt team. Vi hjälper dig gärna.