# HILLS API

> Conecta tus sistemas con HILLS Music: lee tu catálogo, tus entregas y tus ingresos, entrega lanzamientos en DDEX, recibe webhooks y conecta la IA por MCP.

La HILLS API conecta tus propios sistemas con la plataforma de HILLS Music. Sellos, distribuidoras y titulares de catálogo la usan para leer los datos de su catálogo, de sus entregas y de sus regalías, y para entregar lanzamientos, sin depender solo del navegador.

La API ya está disponible. Se incluye en los planes Enterprise y Custom. Consulta [Acceso y planes](https://developer.hillsmusic.com/es/overview/early-access/).

## Qué puedes crear

- **Sincronización del catálogo.** Lee cada lanzamiento con sus pistas, su estado de revisión y su estado en cada plataforma. Usa `updated_since` para sincronizar solo lo que ha cambiado.
- **Entrega de lanzamientos por DDEX.** Envía lotes ERN (se recomienda 4.3) por la API o por SFTP. Cada lanzamiento se convierte en un borrador de tu catálogo y pasa por la revisión y la entrega a las plataformas. Prueba antes el lote: no se crea nada.
- **Seguimiento de entregas.** Sigue cada lanzamiento plataforma por plataforma y recibe un webhook cuando se aprueba, se publica o necesita una corrección.
- **Informes.** Lleva a tu BI o a tus herramientas de contabilidad los ingresos por mes, lanzamiento o plataforma, tu saldo y tus pagos, y las estadísticas de tus smart links.
- **Alta de artistas.** Consulta tus artistas y sellos e invita a otros nuevos.
- **Asistentes de IA.** Conecta Claude, ChatGPT y otros asistentes a tu espacio de trabajo mediante el servidor MCP.

Los lanzamientos solo entran en HILLS como DDEX ERN o a través de la aplicación web. La API no crea ni edita lanzamientos campo a campo, y no tiene una subida aparte para el audio o la portada: los archivos viajan dentro del lote DDEX.

## Las piezas

| | |
| --- | --- |
| API REST | `https://api.hillsmusic.com/v1`, JSON sobre HTTPS, claves de API Bearer. Empieza por el [inicio rápido](https://developer.hillsmusic.com/es/guides/quickstart/). |
| DDEX | `POST /ddex/validate` para probar; `POST /ddex` y las subidas directas para entregar; además, SFTP con las carpetas `/test` y `/production`. Consulta [Entrega DDEX](https://developer.hillsmusic.com/es/guides/ddex/). |
| Webhooks | Eventos firmados de lanzamientos, entregas a plataformas, DDEX, liquidaciones, pagos, solicitudes y soporte en vivo. Consulta [Webhooks](https://developer.hillsmusic.com/es/guides/webhooks/). |
| Servidor MCP | `https://mcp.hillsmusic.com`, 10 herramientas de solo lectura, inicio de sesión OAuth 2.1 con tu cuenta de HILLS. Consulta [Servidor MCP](https://developer.hillsmusic.com/es/mcp/overview/). |

## Cómo funciona el acceso

Hay un solo tipo de clave de API: `hm_live_…`. El propietario de la cuenta, o un miembro del equipo con el permiso de claves de API, crea las claves en la página **Developers** de la aplicación web de HILLS. Cada clave tiene sus propios ámbitos y una caducidad opcional.

No hay un sandbox aparte. Para probar una entrega DDEX, usa la misma clave con `POST /ddex/validate` o la carpeta SFTP `/test`. Las dos ejecutan todas las comprobaciones y no crean nada. Consulta [Carpeta de pruebas](https://developer.hillsmusic.com/es/reference/test-folder/).

## Siguientes pasos

- [Inicio rápido](https://developer.hillsmusic.com/es/guides/quickstart/): crea una clave y haz tus primeras llamadas.
- [Acceso y planes](https://developer.hillsmusic.com/es/overview/early-access/): quién puede usar la API y sus límites.
- [Referencia de la API](https://developer.hillsmusic.com/es/reference/): todos los endpoints.

Fuente: https://developer.hillsmusic.com/es/overview/introduction/