| Portada | Artista unfold_more | Título unfold_more | Álbum unfold_more | Ruta Original | Etiquetas unfold_more | Acciones | |
|---|---|---|---|---|---|---|---|
| Cargando datos... | |||||||
Audiencia
Oyentes registrados en la app de ngradio.es
| ID | Usuario | Likes | Última actividad | Acciones |
|---|---|---|---|---|
| Cargando usuarios... | ||||
Registro de actividad
Quién ha cambiado qué en el panel
| Fecha | Usuario | Acción | Detalle |
|---|
Documentación de la API
Esta sección describe los endpoints disponibles en el backend de NGRADIO y cómo interactuar con ellos.
public Base URL y Autenticación
Todas las peticiones a la API administrativa requieren autenticación.
Los endpoints públicos (como /api/song o /api/history) no requieren header de autorización y pueden ser llamados desde cualquier cliente usando CORS.
lock_open Endpoints Públicos
Devuelve la canción que está sonando actualmente, incluyendo carátula, enlaces a plataformas (Apple Music, Spotify, Deezer) y letras si están disponibles.
Ejemplo: curl https://tu-dominio.com/api/song
Devuelve el historial de canciones reproducidas recientemente.
Parámetros opcionales:
limit: Número de resultados (por defecto: 500)hours: Horas hacia atrás a buscar (por defecto: 48)format: json o xml (por defecto: json)
Devuelve información sobre la siguiente canción programada en RadioBoss (si está expuesta en el XML de getlastplayed).
Obtiene la metadata completa de una canción por su short_code o ID interno de la base de datos.
Endpoint de Server-Sent Events (SSE). Mantiene una conexión abierta y empuja actualizaciones en tiempo real cuando cambia la canción actual. Ideal para reproductores web y widgets.
Endpoint proxy que transmite el flujo de audio del micrófono o entrada de línea desde RadioBoss de manera segura (requiere que RadioBoss esté configurado correctamente con RB_USER, RB_PASS y RB_MIC_KEY).
lock Endpoints Administrativos (Requieren Token)
Notifica al backend para que consulte a RadioBOSS la canción que está sonando actualmente. Se comunica directamente con la API de RadioBOSS y procesa la información de forma asíncrona para evitar saturaciones.
Detalles Técnicos y Protección Anti-Spam:
- El endpoint
/updaterequiere enviar tu token en la querystring:?token=4ff...o en el headerAuthorization: Bearer. - Caché en KV (USER_CACHE): Originalmente se usaba un
ttlde 2 segundos para evitar un ataque por bombardeo de consultas a RadioBOSS. Sin embargo, Cloudflare Workers KV requiere un TTL mínimo de 60 segundos. Si configuras un valor menor, se ignorará el caché en KV. Para evitarlo y permitir a RadioBoss llamar a/updaterecurrentemente, la validación se hace primero y luego el worker obtiene info de RB cada vez con caché opcional. - Procesamiento en Background: Las descargas de carátulas pesadas y búsqueda de metadatos (como iTunes/Spotify/Letras) se ejecutan mediante
ctx.waitUntil()en background. Así el endpoint responde instantáneamente a RadioBOSS con un código HTTP 200, evitando timeouts en la emisora.
Ejemplo en RadioBOSS (HTTP GET): https://core.ngradio.es/update?token=TU_AUTH_TOKEN
Permite buscar y listar canciones en la base de datos local de NGRADIO.
Parámetros:
q: Búsqueda de textolimit: Resultados por páginaoffset: Paginación
Fuerza la sincronización con RadioBoss. Escanea los audios en la librería y los inserta en NGRADIO.
Devuelve el registro de auditoría (logs) con eventos de sincronización, búsquedas y errores del sistema.
Devuelve estadísticas de audiencia y base de datos (canciones más escuchadas, géneros principales, horas pico).
Permite leer o guardar la configuración del sitio público (redes sociales, branding, reproductor, etc).
Para cualquier actualización sobre los endpoints, revisa el archivo worker.js.
Lista de reproducción
Lo que RadioBOSS tiene programado ahora mismo
| Hora | Artista | Título | Duración |
|---|