Visão geral da API

A API pública do LabelGrid permite que desenvolvedores se integrem ao LabelGrid de forma programática: ler seu catálogo, criar e atualizar lançamentos, enviar arquivos e submeter lançamentos para distribuição.

O que a API oferece

A API pública fica em /api/public/... no domínio api.labelgrid.com e oferece acesso programático a:

• Lançamentos: listar, criar, atualizar, excluir; enviar capa; validar; submeter para distribuição
• Faixas: listar, criar, atualizar; enviar arquivos de áudio; gerenciar licenças de faixas
• Selos: listar e gerenciar os perfis dos seus selos
• Artistas: listar e gerenciar perfis de artistas
• Compositores e colaboradores: listar e gerenciar perfis de compositores e colaboradores
• Editoras: listar e gerenciar perfis de editoras
• Webhooks: registrar endpoints de webhook para notificações assíncronas
• Dados de referência: gêneros, idiomas, funções de colaboradores, instrumentos, territórios de distribuição e lojas de distribuição

Casos de uso comuns

• Automatizar a criação de lançamentos a partir dos seus sistemas atuais
• Sincronizar os dados do catálogo com o seu banco de dados
• Criar painéis e ferramentas de relatórios personalizadas
• Integrar com as ferramentas do seu fluxo de trabalho atual
• Oferecer serviços de distribuição white-label sobre o LabelGrid

---

Como obter acesso à API

Para usar a API do LabelGrid, você precisa de:

1. Uma conta LabelGrid com acesso à API habilitado no plano
2. Um token de API gerado nas configurações da sua conta: abra o menu do avatar no canto superior direito e clique em API Tokens (visível apenas se o acesso à API estiver habilitado)
3. (Opcional) Lista de IPs permitidos para mais segurança, configurada na mesma área

Se você não encontra a opção API Tokens na sua conta, fale com o suporte para conversar sobre habilitar o acesso à API no seu plano.

---

Autenticação

Toda requisição à API precisa incluir um token Bearer no cabeçalho Authorization:

Authorization: Bearer YOUR_API_TOKEN

---

Documentação da API

Para a referência completa de endpoints, os esquemas de requisição/resposta e a ferramenta interativa “try it”, consulte a documentação gerada automaticamente:

• Produção: https://api.labelgrid.com/docs/api
• Sandbox: https://api-sandbox.stg.labelgrid.com/docs/api

A documentação inclui:

• Guia de autenticação
• Todos os endpoints disponíveis, com exemplos de requisição e resposta
• Informações sobre limites de requisições (rate limiting)
• Configuração de webhooks

---

Sandbox

O LabelGrid oferece um ambiente de sandbox para que você desenvolva e teste contra a API sem afetar seu catálogo de produção. As contas de sandbox são provisionadas sob solicitação: fale com o suporte para configurar uma.

---

Webhooks

A API pública oferece webhooks para notificação assíncrona de eventos (mudanças de status de revisão, atualizações de entrega, etc.). Consulte Webhooks para a configuração e os tipos de evento disponíveis.

---

Relacionados

Está construindo sobre a API do LabelGrid? Consulte o hub para desenvolvedores para ter uma visão do que é possível. Se você opera um serviço de distribuição white-label sobre o LabelGrid, a página infraestrutura para distribuidores mostra o panorama completo.

---

Precisa de ajuda?

Se precisar de ajuda com a API, fale com nossa equipe de suporte com detalhes técnicos sobre a sua integração.