Documentación
Guías
Inicio rápido, autenticación, solicitudes, errores, límites, paginación, webhooks y entrega DDEX.
- Inicio rápido Crea una clave de API en la aplicación web de HILLS, compruébala con /me y después lista tus lanzamientos y consulta tus ingresos. Unos cinco minutos.
- Autenticación Envía tu clave de API hm_live_ como token Bearer. Cómo crear claves, elegir ámbitos, fijar la caducidad, rotarlas y revocarlas, y qué significa cada error.
- Solicitudes a la API URL base, formato JSON de solicitudes y respuestas, cabeceras de respuesta, versiones y obsolescencias, y qué enviar a soporte cuando algo falla.
- Errores El formato de los errores, cada estado y código que responde la API, qué errores conviene reintentar y un gestor de errores en Node listo para copiar.
- Límites de solicitudes Solicitudes por minuto y clave de API en cada plan, las cabeceras X-RateLimit, cómo es un 429 y cómo esperar y mantenerte por debajo del límite.
- Paginación Recorre los lanzamientos con cursor y next_cursor, las entregas de webhooks con before y has_more, y sincroniza solo lo que ha cambiado.
- Webhooks Recibe eventos de HILLS Music en tu endpoint HTTPS: suscripción, los 13 tipos de evento, el sobre, la firma X-Hills-Signature, reintentos y registro.
- Entrega DDEX Envía lanzamientos como DDEX ERN: prueba un lote con POST /ddex/validate, entrégalo con POST /ddex o subidas directas, usa SFTP y lee el informe.