Acceso y planes
La HILLS API, los webhooks y MCP se incluyen en los planes Enterprise y Custom. Quién puede crear claves, los límites de solicitudes y cómo obtener acceso.
Actualizado el
La HILLS API está disponible para las cuentas de socio con los planes Enterprise y Custom.
Planes
| Enterprise | Custom | |
|---|---|---|
| API REST y DDEX por la API | Sí | Sí |
| Webhooks | Sí | Sí |
| Solicitudes por minuto, por clave | 120 | Según tu volumen (600 salvo otro acuerdo) |
Con otros planes, las claves no funcionan y responden 403 api_not_in_plan, y no se pueden añadir endpoints de webhook. Si cambias a un plan inferior, las claves existentes dejan de funcionar hasta que el plan vuelva a incluir la API. No se elimina nada. Puedes seguir probando archivos DDEX desde la página DDEX de la aplicación web y desde tu carpeta SFTP /test.
Para pasar a Enterprise o Custom, habla con tu contacto en HILLS Music. Si todavía no eres socio, solicita acceso a la API. Cuéntanos qué quieres conectar y cuántos lanzamientos y solicitudes esperas, aproximadamente.
Qué obtienes
- Claves de API. Un solo tipo de clave,
hm_live_…, con sus propios ámbitos y una caducidad opcional. Consulta Autenticación. - Una vía de pruebas que no crea nada.
POST /ddex/validatey la carpeta SFTP/testejecutan todas las comprobaciones de una entrega y responden con un informe. Consulta Carpeta de pruebas. - Entrega DDEX. Se recomienda ERN 4.3 y se aceptan versiones anteriores, por la API o por SFTP. Consulta Entrega DDEX.
- Webhooks. Hasta 20 endpoints HTTPS, eventos firmados y reintentos. Consulta Webhooks.
- El servidor MCP. Conecta asistentes de IA a tu espacio de trabajo. Más información abajo.
Quién puede crear claves
Las claves se crean en la página Developers de la aplicación web de HILLS. El propietario de la cuenta siempre puede crearlas. Un miembro del equipo puede hacerlo si su rol tiene el permiso de claves de API, que se configura en Settings → Team. Los artistas y sellos que dependen de tu cuenta no pueden crear claves: la API es tuya, y cada respuesta abarca tu cuenta y los artistas y sellos que dependen de ella.
Servidor MCP
El servidor MCP en https://mcp.hillsmusic.com permite que los asistentes de IA lean tu catálogo, el estado de tus lanzamientos, tus reproducciones e ingresos, tus liquidaciones y tus solicitudes. Tiene 10 herramientas de solo lectura. Cada persona inicia sesión con su propia cuenta de HILLS mediante OAuth 2.1, sin clave de API. Pueden conectarlo las cuentas de socio y los miembros de su equipo, y estos necesitan el permiso de rol que indica cada herramienta. Consulta Servidor MCP.
Cambios
La API v1 es estable. Con el tiempo se añaden campos. Cuando algo tiene que desaparecer, se anuncia en el registro de cambios con una fecha de baja, y hasta entonces las respuestas que lo usan llevan las cabeceras Deprecation y Sunset. Consulta Solicitudes a la API.