Metadata de una estación
GET / JSONReemplaza {slug} por el slug público de la estación. Esta ruta no tiene operaciones de escritura.
curl -sS -H 'Accept: application/json' 'https://aircastpanel.com/api/v1/estacion/{slug}'
Consulta metadata pública, crea un reproductor o directorio y mantén tu propio producto sincronizado con la señal. Esta API no necesita credenciales privadas.
La API pública es deliberadamente pequeña: identifica la estación, consulta su estado, muestra los campos útiles y refresca sin generar tráfico innecesario.
Usa el último segmento de la URL pública. Por ejemplo, radio-centro en /radio/radio-centro.
Reemplaza {slug} por el slug público. La ruta versionada es el contrato recomendado para integraciones nuevas.
Envía una petición GET desde tu servidor o navegador. Es de solo lectura: no cambia playlists, runtime ni facturación.
Cachea la respuesta entre 15 y 30 segundos, controla los timeouts y muestra un estado útil si falla la red.
La respuesta contiene lo necesario para un reproductor público, directorio de radios, aplicación móvil o sitio personalizado.
Reemplaza {slug} por el slug público de la estación. Esta ruta no tiene operaciones de escritura.
curl -sS -H 'Accept: application/json' 'https://aircastpanel.com/api/v1/estacion/{slug}'
Los valores cambian según la estación, pero la estructura se mantiene estable dentro de v1.
{\n "ok": true,\n "version": "v1",\n "estacion": {\n "slug": "radio-centro",\n "online": true,\n "cancion": "Artista - Título",\n "oyentes_actuales": 42,\n "bitrate": 128,\n "formato": "mp3",\n "url_stream": "https://tu-dominio.example/play/radio-centro.m3u",\n "url_cover": "https://tu-dominio.example/cover/radio-centro"\n }\n}
Úsalo primero para confirmar que la estación devuelve JSON válido desde tu servidor.
curl -sS -H 'Accept: application/json' 'https://aircastpanel.com/api/v1/estacion/{slug}'
La misma solicitud puede ejecutarse en frontend cuando tu aplicación cumple la política CORS del navegador.
const response = await fetch("https://aircastpanel.com/api/v1/estacion/{slug}", {
headers: { Accept: 'application/json' },
cache: 'no-store'
});
const data = await response.json();
const station = data.estacion || {};
console.log(station.cancion || 'Sin metadata');
Usa solo los datos necesarios y conserva una interfaz estable cuando la metadata esté vacía.
estacion.online
Indica si la señal pública está disponible en ese momento.
estacion.cancion
Metadata actual o un valor vacío cuando no está disponible.
estacion.oyentes_actuales
Cantidad de oyentes expuesta por la estación.
estacion.bitrate / formato
Datos técnicos para etiquetas del reproductor o directorio.
estacion.url_stream
URL pública del stream para un reproductor de audio.
estacion.url_cover
URL pública de portada cuando la estación tiene imagen.
Elige el recurso según tu caso de uso. Ninguna de estas rutas permite controlar la estación.
La API privada es un contrato separado para plataformas de billing como WHMCS. Usa Bearer tokens, scopes, límites y auditoría. Nunca uses un endpoint público para automatizar cuentas.