Acesso e planos
A HILLS API, os webhooks e o MCP vêm com os planos Enterprise e Custom. Quem pode criar chaves, os limites de requisições e como obter acesso.
Atualizado em
A HILLS API está no ar para contas de cliente nos planos Enterprise e Custom.
Planos
| Enterprise | Custom | |
|---|---|---|
| API REST e DDEX via API | Sim | Sim |
| Webhooks | Sim | Sim |
| Requisições por minuto, por chave | 120 | Definido conforme o seu volume (600, salvo acordo em contrário) |
Nos outros planos, as chaves não funcionam e respondem 403 api_not_in_plan, e não é possível adicionar endpoints de webhook. Se o seu plano for rebaixado, as chaves existentes param de funcionar até que o plano volte a incluir a API. Nada é excluído. Você continua podendo testar arquivos DDEX na página DDEX do app web e na sua pasta SFTP /test.
Para mudar para o Enterprise ou o Custom, fale com o seu contato na HILLS Music. Se você ainda não é cliente, solicite acesso à API. Conte o que você quer conectar e, aproximadamente, quantos lançamentos e requisições espera.
O que você recebe
- Chaves de API. Um único tipo de chave,
hm_live_…, com escopos próprios e validade opcional. Veja Autenticação. - Um caminho de teste que não cria nada.
POST /ddex/validatee a pasta SFTP/testexecutam todas as verificações de uma entrega e respondem com um relatório. Veja Pasta de teste. - Entrega DDEX. ERN 4.3 recomendado, versões anteriores aceitas, pela API ou por SFTP. Veja Entrega DDEX.
- Webhooks. Até 20 endpoints HTTPS, eventos assinados e novas tentativas. Veja Webhooks.
- O servidor MCP. Conecte assistentes de IA ao seu espaço de trabalho. Veja abaixo.
Quem pode criar chaves
As chaves são criadas na página Developers do app web da HILLS. O proprietário da conta sempre pode criá-las. Um membro da equipe pode, se a função dele tiver a permissão de chaves de API, definida em Settings → Team. Os artistas e gravadoras vinculados à sua conta não podem criar chaves: a API é sua, e cada resposta cobre a sua conta e os artistas e gravadoras vinculados a ela.
Servidor MCP
O servidor MCP em https://mcp.hillsmusic.com permite que assistentes de IA leiam seu catálogo, o status dos lançamentos, streams e receita, relatórios de royalties e solicitações. Ele tem 10 ferramentas somente leitura. As pessoas entram com a própria conta HILLS via OAuth 2.1, sem chave de API. Contas de cliente e os membros da equipe delas podem conectá-lo, e os membros da equipe precisam da permissão de função que cada ferramenta indica. Veja Servidor MCP.
Mudanças
A API v1 é estável. Campos são adicionados com o tempo. Quando algo precisa sair, isso é anunciado no changelog com uma data de desativação, e as respostas que usam esse recurso trazem os headers Deprecation e Sunset até lá. Veja Como fazer requisições.