# 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.

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](https://developer.hillsmusic.com/pt/overview/early-access/).

## 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_since` para 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](https://developer.hillsmusic.com/pt/guides/quickstart/). |
| 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](https://developer.hillsmusic.com/pt/guides/ddex/). |
| Webhooks | Eventos assinados para lançamentos, entrega às plataformas, DDEX, relatórios de royalties, pagamentos, solicitações e Live support. Veja [Webhooks](https://developer.hillsmusic.com/pt/guides/webhooks/). |
| Servidor MCP | `https://mcp.hillsmusic.com`, 10 ferramentas somente leitura, login OAuth 2.1 com a sua conta HILLS. Veja [Servidor MCP](https://developer.hillsmusic.com/pt/mcp/overview/). |

## 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](https://developer.hillsmusic.com/pt/reference/test-folder/).

## Próximos passos

- [Início rápido](https://developer.hillsmusic.com/pt/guides/quickstart/): crie uma chave e faça suas primeiras chamadas.
- [Acesso e planos](https://developer.hillsmusic.com/pt/overview/early-access/): quem pode usar a API e os limites.
- [Referência da API](https://developer.hillsmusic.com/pt/reference/): todos os endpoints.

Fonte: https://developer.hillsmusic.com/pt/overview/introduction/