Preflight QC

O Preflight QC é um complemento premium que oferece um controle de qualidade profissional dos seus lançamentos. Envie um lançamento e o Preflight QC o analisa de ponta a ponta: metadados, datas de lançamento, áudio, capa e documentação de licenças. Você recebe um relatório de qualidade claro e acionável. Corrija o que ele apontar no seu próprio ritmo e, quando estiver satisfeito, confirme o lançamento para análise.

Para selos e integradores da API, o Preflight QC funciona como um bloco de construção. Obtenha o relatório de qualidade de forma programática, conecte-o ao seu próprio fluxo de QA, condicione o seu processo interno de aprovação aos resultados e confirme lançamentos para análise automaticamente. A sua equipe define o padrão de qualidade, e o Preflight QC faz a análise.

Um lançamento que chega limpo avança rápido pela análise. O Preflight QC leva você até lá antes de enviar.

O que é o Preflight QC

Com o Preflight QC ativado na sua conta, enviar um lançamento para distribuição não o manda direto para a fila de análise. Em vez disso, o lançamento entra em uma espera pré-análise (“aguardando a sua revisão”) enquanto o Preflight QC executa sua análise de qualidade: metadados, datas de lançamento, áudio, capa e documentação de licenças. O resultado é um relatório de qualidade, e o que você constrói sobre ele é decisão sua:

• Seu próprio fluxo de QA (API). Passe o seu catálogo pela análise de qualidade, obtenha o relatório de forma programática no seu próprio fluxo de QA, condicione o seu processo interno de aprovação aos resultados e confirme cada lançamento para análise somente quando ele passar pelo seu crivo. Veja Usar a API para integrações.
• O fluxo no aplicativo. Leia o relatório na página do lançamento, corrija o que ele apontar e confirme quando estiver satisfeito.

Nos dois casos, é a confirmação que move o lançamento para a fila de análise normal: nada entra em análise até você dar o aval.

O Preflight QC adiciona uma etapa de qualidade antes da análise. Ele não muda o que acontece depois: assim que você confirma, o seu lançamento passa pelo mesmo processo de validação e análise que qualquer outro lançamento.

Como obter o Preflight QC

O Preflight QC é um complemento premium ativado por conta pela nossa equipe. Para ativá-lo na sua conta, entre em contato com a nossa equipe de vendas e informe que deseja o Preflight QC.

Depois de ativado, você verá a nova etapa de espera e confirmação na próxima vez que enviar um lançamento para distribuição.

O fluxo de trabalho do Preflight QC

Este é o caminho completo de um lançamento com o Preflight QC ativado, do envio à análise.

1. Envie o seu lançamento para distribuição

Crie e conclua o seu lançamento como de costume e, depois, envie-o para distribuição. Com o Preflight QC ativado, isso não coloca o lançamento na fila de análise de imediato. Em vez disso, o lançamento passa para uma espera pré-análise e é marcado como aguardando a sua revisão.

2. A análise de qualidade é executada

Enquanto o seu lançamento está em espera, o Preflight QC o analisa de ponta a ponta. A análise cobre:

• Metadados: títulos, artistas, créditos e outros detalhes do lançamento e das faixas
• Datas de lançamento: a configuração de datas e as versões do lançamento
• Áudio: os arquivos de áudio que você enviou
• Capa: a sua imagem de capa
• Licenças: quando um cover, um sample ou algo semelhante precisa de documentação de apoio

A análise costuma terminar poucos minutos depois de o envio e a transcodificação serem concluídos. Enquanto ainda está em andamento, o relatório de qualidade indica que as verificações estão em andamento e ainda não lista nenhum problema.

3. Leia o seu relatório de qualidade

Assim que a análise terminar, abra o relatório de qualidade do lançamento para ver o que, se houver algo, precisa da sua atenção. Você pode lê-lo em dois lugares:

• Pela API pública, para o seu próprio fluxo de QA; veja Usar a API mais abaixo.
• No aplicativo, na página do lançamento.

O relatório lista cada problema com um título claro e uma mensagem que descreve o que corrigir. Veja Entender o relatório de qualidade para saber como ler os campos.

4. Corrija o que for apontado

Percorra os problemas do seu relatório:

• Problemas de metadados: edite os detalhes do lançamento ou da faixa.
• Problemas de áudio ou de capa: substitua o arquivo afetado.
• Problemas que pedem um retorno: responda no tópico de notas do problema ou envie o documento solicitado (por exemplo, uma licença para um cover ou um sample).

Editar o seu lançamento enquanto ele está em espera executa novamente as partes pertinentes da análise, e o relatório é atualizado com os novos resultados. Você pode repetir esse ciclo quantas vezes precisar.

5. Confirme o lançamento

Quando o seu relatório estiver limpo, ou você tiver tratado tudo o que precisava, confirme o lançamento. No aplicativo, é um botão de confirmação no lançamento; para integrações, é o endpoint de confirmação.

A confirmação tira o lançamento da espera e o move para a fila de análise normal. A confirmação exige que a análise esteja concluída: se você editou o lançamento após a última execução, aguarde o relatório atualizado antes de confirmar.

6. Análise normal

Após a confirmação, o seu lançamento é analisado exatamente como qualquer outro. Para saber o que acontece durante a análise, os prazos e os resultados possíveis, veja Validação e análise.

Entender o relatório de qualidade

O relatório de qualidade tem duas partes: uma lista de problemas e um pequeno bloco de detalhes do relatório sobre a execução em si.

Problemas

Cada problema no relatório descreve um ponto a examinar. Os campos com que você vai trabalhar:

Campo	O que ele indica
Título	Um nome curto e em linguagem simples para o problema.
Mensagem	O que é o problema e o que fazer a respeito.
Gravidade	A importância do problema, para ajudar você a priorizar.
Bloqueante	Se o problema precisa ser resolvido antes de você poder confirmar (veja abaixo).
Exige retorno	Se o problema precisa de uma resposta escrita ou de um documento enviado por você.
Descrição personalizada	Detalhes adicionais específicos do seu lançamento, quando disponíveis.
Faixas afetadas	A quais faixas o problema se aplica. Problemas no nível do lançamento não listam faixas específicas.

Bloqueante ou informativo

• Problemas bloqueantes precisam ser resolvidos antes de você poder confirmar o lançamento para análise. Corrija o que eles descrevem, deixe a análise ser executada novamente e eles sairão do seu relatório.
• Problemas informativos estão ali para sinalizar algo que vale um olhar, mas não impedem você de confirmar. Analise-os e confirme quando estiver pronto.

Problemas que exigem retorno

Alguns problemas não se resolvem só com edição: eles precisam de algo de você, como uma explicação escrita ou um documento de apoio (por exemplo, uma licença para um cover ou um sample). Eles são marcados como exige retorno. Para resolver um deles, responda no tópico de notas do problema ou envie o documento solicitado antes de confirmar.

Os detalhes do relatório

Ao lado dos problemas, o relatório inclui alguns detalhes sobre a execução:

Campo	O que ele indica
generated_at	Quando o relatório atual foi produzido. Fica vazio enquanto a primeira análise ainda está em andamento.
checks_in_progress	true enquanto a análise ainda está em andamento; a lista de problemas fica vazia até que termine.
hold	Se o lançamento está atualmente na espera pré-análise.
review_status	O status de análise atual do lançamento.
profile	O perfil de qualidade aplicado a este lançamento.

Usar a API para integrações

Se você desenvolve sobre a API pública do LabelGrid, pode conectar o Preflight QC ao seu próprio pipeline: passe cada lançamento pela análise de qualidade, leve o relatório para o seu próprio fluxo de QA, condicione o seu processo interno de aprovação aos resultados e confirme para análise a partir das suas próprias ferramentas. O Preflight QC oferece dois endpoints para isso, ambos com a mesma autenticação por token Bearer que o restante da API pública. Para os esquemas completos e sempre atualizados de requisição e resposta, veja a referência da API.

Obter o relatório de qualidade

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

Retorna o relatório de qualidade atual do lançamento. A resposta traz:

• issues[]: uma entrada por problema, cada uma com code (uma string estável; veja Trabalhar com os códigos de problema), title, message, severity, is_blocking, requires_feedback, custom_description e affected_tracks.
• report: generated_at, checks_in_progress, hold, review_status e profile.

Enquanto a análise ainda está em andamento, o relatório retorna checks_in_progress: true com uma lista issues vazia. Consulte o endpoint periodicamente até que generated_at esteja preenchido, normalmente poucos minutos após o término do envio e da transcodificação, e então leia os problemas.

Um exemplo de resposta com a análise concluída:

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

Confirmar o lançamento para análise

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

Tira o lançamento da espera e o move para a fila de análise normal: o equivalente, via API, ao botão de confirmação no aplicativo.

A confirmação exige que a análise esteja concluída. Se o lançamento foi editado após a última execução da análise, o relatório está sendo regenerado e o endpoint retorna um conflito. Quando isso acontecer, busque o relatório de qualidade novamente, aguarde até que generated_at esteja preenchido de novo e tente a confirmação outra vez.

Trabalhar com os códigos de problema

Se você constrói lógica sobre o relatório de qualidade, baseie-a no code do problema:

• code é uma string estável em formato slug (por exemplo, audio.trailing-silence). É seguro mapear os códigos no seu sistema e construir lógica sobre eles.
• Títulos e mensagens são textos para pessoas. Eles podem ser refinados com o tempo; nunca baseie a sua lógica no texto, use-o apenas para exibição.
• Códigos novos podem surgir à medida que a cobertura do Preflight QC se expande. Trate códigos desconhecidos de forma genérica: exiba o title e a message da resposta em vez de falhar.
• Seus relatórios ensinam os códigos que importam. À medida que você passa lançamentos pelo Preflight QC, os códigos relevantes para o seu catálogo aparecem naturalmente nos seus próprios relatórios de qualidade.
• O que a análise cobre. Os problemas se enquadram nestas categorias: metadados do lançamento e das faixas, datas e versões do lançamento, qualidade do áudio, capa, e licenças e documentação.

O catálogo de problemas

Para mapear os problemas ao montar o seu próprio fluxo de QA, recupere o catálogo completo de forma programática:

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

Ele retorna todos os problemas que podem aparecer em um relatório de qualidade, indexados pelo seu código de string estável, com o título, o modelo da mensagem, a gravidade, o indicador de bloqueio e requires_feedback. O endpoint está disponível apenas para contas com o complemento Preflight QC.

Perguntas frequentes

E se a análise de qualidade ainda estiver em andamento?

O relatório mostrará checks_in_progress: true sem problemas listados por enquanto. Isso é normal logo após o envio. Aguarde alguns minutos depois de o envio e a transcodificação terminarem e verifique de novo: no aplicativo, o relatório se atualiza sozinho e, pela API, você pode consultá-lo periodicamente até que generated_at esteja preenchido.

Posso editar o meu lançamento enquanto ele está em espera?

Sim. Editar um lançamento na espera pré-análise executa novamente as partes pertinentes da análise e atualiza o relatório, então você pode corrigir os problemas e ver os resultados atualizados sem sair da espera. Lembre-se apenas de que, depois de uma edição, você precisará aguardar o relatório atualizado antes de poder confirmar.

O que acontece depois que eu confirmo?

O seu lançamento sai da espera e entra na fila de análise normal, onde é analisado como qualquer outro. Veja Validação e análise para saber como a análise funciona, quanto tempo leva e os resultados possíveis.

Posso voltar um lançamento para rascunho?

Sim: enquanto o seu lançamento está na espera pré-análise e você ainda não o confirmou, ele não entrou em análise, então você fica livre para continuar editando-o ou deixá-lo como rascunho e voltar mais tarde. Ele só entra na fila de análise quando você o confirma.

Preciso corrigir todos os problemas antes de confirmar?

Você precisa resolver os problemas bloqueantes antes de poder confirmar. Os problemas informativos não impedem você de confirmar, mas valem um olhar: resolver o máximo possível antes da análise é o caminho mais rápido para a aprovação.

---

Dúvidas sobre o Preflight QC? Entre em contato com a nossa equipe. Teremos prazer em ajudar.