HILLS API
Conecte seus sistemas à HILLS Music: leia catálogo, entregas e ganhos, entregue lançamentos em DDEX, receba webhooks e conecte IA via MCP.
Atualizado em
A HILLS API conecta os seus próprios sistemas à plataforma da HILLS Music. Gravadoras, distribuidoras e detentores de catálogo a usam para ler dados de catálogo, de entrega e de royalties, e para entregar lançamentos, sem depender só do navegador.
A API está no ar. Ela vem com os planos Enterprise e Custom. Veja Acesso e planos.
O que você pode criar
- Sincronização de catálogo. Leia cada lançamento com suas faixas, o status da revisão e o status em cada plataforma. Use
updated_sincepara sincronizar só o que mudou. - Entrega de lançamentos via DDEX. Envie lotes ERN (4.3 recomendado) pela API ou por SFTP. Cada lançamento vira um rascunho no seu catálogo e passa pela revisão e pela entrega às plataformas. Teste o lote antes: nada é criado.
- Acompanhamento de entregas. Acompanhe cada lançamento plataforma por plataforma e receba um webhook quando ele for aprovado, entrar no ar ou precisar de correção.
- Relatórios. Leve a receita por mês, lançamento ou plataforma, seu saldo e seus pagamentos, e as estatísticas dos smartlinks para o seu BI ou suas ferramentas de contabilidade.
- Onboarding de artistas. Liste seus artistas e gravadoras e convide novos.
- Assistentes de IA. Conecte Claude, ChatGPT e outros assistentes ao seu espaço de trabalho pelo servidor MCP.
Os lançamentos só entram na HILLS em DDEX ERN ou pelo app web. A API não cria nem edita um lançamento campo a campo, e não tem upload separado de áudio ou capa: os arquivos vão dentro do lote DDEX.
As peças
| API REST | https://api.hillsmusic.com/v1, JSON sobre HTTPS, chaves de API Bearer. Comece pelo Início rápido. |
| DDEX | POST /ddex/validate para testar, POST /ddex e uploads diretos para entregar, além de SFTP com as pastas /test e /production. Veja Entrega DDEX. |
| Webhooks | Eventos assinados para lançamentos, entrega às plataformas, DDEX, relatórios de royalties, pagamentos, solicitações e Live support. Veja Webhooks. |
| Servidor MCP | https://mcp.hillsmusic.com, 10 ferramentas somente leitura, login OAuth 2.1 com a sua conta HILLS. Veja Servidor MCP. |
Como funciona o acesso
Existe um único tipo de chave de API, hm_live_…. O proprietário da conta, ou um membro da equipe com a permissão de chaves de API, cria as chaves na página Developers do app web da HILLS. Cada chave tem seus próprios escopos e uma validade opcional.
Não existe sandbox separado. Para testar uma entrega DDEX, use a mesma chave com POST /ddex/validate, ou a pasta SFTP /test. As duas executam todas as verificações e não criam nada. Veja Pasta de teste.
Próximos passos
- Início rápido: crie uma chave e faça suas primeiras chamadas.
- Acesso e planos: quem pode usar a API e os limites.
- Referência da API: todos os endpoints.