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

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](https://hillsmusic.com/apply/?type=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](https://developer.hillsmusic.com/pt/guides/authentication/).
- **Um caminho de teste que não cria nada.** `POST /ddex/validate` e a pasta SFTP `/test` executam todas as verificações de uma entrega e respondem com um relatório. Veja [Pasta de teste](https://developer.hillsmusic.com/pt/reference/test-folder/).
- **Entrega DDEX.** ERN 4.3 recomendado, versões anteriores aceitas, pela API ou por SFTP. Veja [Entrega DDEX](https://developer.hillsmusic.com/pt/guides/ddex/).
- **Webhooks.** Até 20 endpoints HTTPS, eventos assinados e novas tentativas. Veja [Webhooks](https://developer.hillsmusic.com/pt/guides/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](https://developer.hillsmusic.com/pt/mcp/overview/).

## Mudanças

A API v1 é estável. Campos são adicionados com o tempo. Quando algo precisa sair, isso é anunciado no [changelog](https://developer.hillsmusic.com/pt/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](https://developer.hillsmusic.com/pt/guides/making-requests/#versioning).

Fonte: https://developer.hillsmusic.com/pt/overview/early-access/