Guia de upload em massa

Para selos com catálogos grandes, as ferramentas de upload em massa economizam muito tempo. A LabelGrid oferece dois métodos para enviar vários lançamentos: integração por API e importação DDEX.

Métodos de upload em massa

Opções disponíveis

Método	Ideal para	Plano necessário
Integração por API	Fluxos automatizados, integrações personalizadas	Planos com acesso à API habilitado
Importação DDEX	Feeds no padrão do setor, fluxos de grandes gravadoras	Planos Enterprise / com API (fale com o suporte)

Nota

Os métodos de upload em massa estão disponíveis em planos com acesso à API habilitado. Se o seu plano não inclui acesso à API, você pode criar lançamentos individualmente pelo painel da LabelGrid ou falar com o suporte para discutir a habilitação do acesso à API.

---

Integração por API

Visão geral

A API da LabelGrid permite criar e gerenciar lançamentos de forma programática, possibilitando fluxos totalmente automatizados para catálogos grandes.

O que você pode fazer

• Criar lançamentos de forma programática
• Enviar arquivos de áudio via API
• Gerenciar metadados em massa
• Automatizar fluxos de distribuição
• Integrar com os seus sistemas existentes

Como começar

1. Habilite o acesso à API no seu plano (fale com o suporte caso ele ainda não esteja habilitado)
2. Gere as credenciais da API nas configurações da sua conta
3. Revise a documentação da API para conhecer os detalhes dos endpoints
4. Implemente a sua integração ou use os nossos SDKs
5. Teste no ambiente de staging antes de ir para produção

Exemplo de requisição

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"
    }
  ]
}

Como registrar o seu distribuidor anterior

Quando você está migrando lançamentos que já estão no ar em outro lugar, a API pública de Releases aceita o campo opcional transfer_from_distributor (texto livre, até 255 caracteres) para registrar o distribuidor de onde você está saindo. Ele se torna somente leitura assim que o lançamento é distribuído, então preencha-o antes do envio ou no momento dele.

Vantagens da API

• Automação completa - sem necessidade de intervenção manual
• Integração de sistemas - conecte com o seu DAM, CRM ou outras ferramentas
• Lançamentos agendados - coloque lançamentos na fila para distribuição futura
• Validação personalizada - valide o conteúdo antes do envio
• Notificações por webhook - receba atualizações em tempo real sobre o status de entrega
• Tratamento de erros - detecção e nova tentativa de erros de forma programática

Limites de taxa

A API tem limites de taxa para garantir a estabilidade do sistema. Consulte a Visão geral da API para os detalhes atuais sobre limites de taxa.

Consulte a Visão geral da API para a documentação completa.

---

Importação DDEX

Visão geral

O DDEX (Digital Data Exchange) é o formato padrão do setor usado pelas grandes gravadoras para entregar conteúdo aos distribuidores. A LabelGrid oferece suporte à importação DDEX para clientes enterprise que já possuem infraestrutura de entrega DDEX.

O que é DDEX?

O DDEX é um padrão baseado em XML que empacota:

• Metadados do lançamento
• Informações das faixas
• Referências aos arquivos de áudio
• Capas e demais arquivos
• Termos de negócio e territórios

Formatos compatíveis

Versão	Status
ERN 4.3.2	Compatível (recomendada)
ERN 4.3.1	Compatível
ERN 4.3.0	Compatível
ERN 3.8.2	Compatível (legada)

Processo de configuração do DDEX

1. Fale com o suporte para solicitar a habilitação do DDEX
2. Conclua a integração com a nossa equipe técnica
3. Configure os ajustes de entrega e os caminhos dos arquivos
4. Configure as credenciais SFTP para a transferência segura de arquivos
5. Envie uma entrega de teste para validação
6. Comece as entregas de produção após a aprovação

Fluxo de entrega

Seu sistema → XML DDEX + arquivos → Upload por SFTP → Processamento da LabelGrid → Distribuição

Requisitos do DDEX

Requisito	Detalhes
Plano	Acesso à API habilitado (fale com o suporte)
Formato	ERN 4.3.2 preferida (4.3.1, 4.3.0 e 3.8.2 também compatíveis)
Entrega	Somente SFTP
Arquivos	Áudio incluído ou referenciado
Validação	Validação prévia recomendada

Quando usar o DDEX

A importação DDEX é ideal se:

• Você já possui infraestrutura de entrega DDEX
• Você está migrando de outro distribuidor que usa DDEX
• O seu sistema de gestão de conteúdo exporta DDEX nativamente
• Você é uma grande gravadora ou um independente de grande porte com fluxos consolidados

Quando usar a API

A API REST/JSON é melhor se:

• Você está construindo uma integração nova do zero
• Você prefere APIs web modernas em vez de XML
• Você precisa de comunicação bidirecional em tempo real
• Você quer notificações por webhook

---

Como escolher o seu método

Fator	Integração por API	Importação DDEX
Complexidade de configuração	Menor	Maior
Infraestrutura existente	Construir do zero	Usar DDEX existente
Formato	JSON	XML
Método de entrega	HTTPS	SFTP
Atualizações em tempo real	Sim (webhooks)	Exige polling
Ideal para	Integrações novas	Migração enterprise

---

Tempos de processamento

Depois que o conteúdo é enviado via API ou DDEX, o tempo de processamento depende de:

• Número de lançamentos e faixas
• Tamanho dos arquivos de áudio
• Complexidade dos metadados
• Carga atual do sistema

Catálogos maiores naturalmente levam mais tempo para serem processados. Fale com o suporte se precisar de orientação sobre os prazos esperados para o tamanho específico do seu catálogo.

---

Limites de envio para migrações grandes

A sua conta pode estar sujeita a um limite móvel de envios de lançamentos em 7 dias. Quando ele está ativo, conta cada envio de lançamento da sua conta, incluindo lançamentos enviados pela API e por importações DDEX, e reenviar um lançamento também conta para o limite.

Se você está planejando uma migração grande de catálogo, de uma só vez, e prevê enviar mais de 20 lançamentos em uma semana, trate isso como uma atividade guiada: fale com o suporte primeiro para planejarmos junto com você. O suporte pode liberar uma janela temporária de isenção para a migração, então entre em contato antes de começar os envios, em vez de esbarrar no limite no meio da migração.

Confirme que todas as faixas foram importadas

Após uma importação em massa ou DDEX, confirme que todas as faixas foram importadas corretamente antes de distribuir.

---

Relacionados

Gerencia um catálogo grande? Veja gestão de catálogo no nosso site para entender como a LabelGrid mantém os seus lançamentos organizados em escala.

---

Precisa de ajuda?

Para receber ajuda com a configuração do upload em massa:

• Integração por API: consulte a Visão geral da API ou fale com o suporte
• Habilitação do DDEX: fale com a nossa equipe de suporte informando os seus requisitos

A nossa equipe pode ajudar você a escolher o método certo e orientar você na configuração.