Entrar Ver planes
API pública / guía de integración

Conecta tu estación sin entrar al panel.

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.

v1
Versión
Solo GET
Método
Sin token
Acceso público
JSON
Formato
Empieza en cuatro pasos

Del slug público a la metadata utilizable.

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.

01

Encuentra el slug de la estación

Usa el último segmento de la URL pública. Por ejemplo, radio-centro en /radio/radio-centro.

02

Construye el endpoint

Reemplaza {slug} por el slug público. La ruta versionada es el contrato recomendado para integraciones nuevas.

03

Solicita el JSON

Envía una petición GET desde tu servidor o navegador. Es de solo lectura: no cambia playlists, runtime ni facturación.

04

Refresca con criterio

Cachea la respuesta entre 15 y 30 segundos, controla los timeouts y muestra un estado útil si falla la red.

Endpoint recomendado

Metadata de una estación

La respuesta contiene lo necesario para un reproductor público, directorio de radios, aplicación móvil o sitio personalizado.

Metadata de una estación

GET / JSON
GET https://aircastpanel.com/api/v1/estacion/{slug}

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}'

Forma de la respuesta

200 OK

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}

Ejemplo con cURL

Ú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}'

Ejemplo en navegador

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');
Campos útiles

Campos útiles

Usa solo los datos necesarios y conserva una interfaz estable cuando la metadata esté vacía.

Campos útiles

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.

Recursos públicos relacionados

Elige el recurso según tu caso de uso. Ninguna de estas rutas permite controlar la estación.

GET
/api/v1/estacion/{slug} Metadata recomendada
GET
/api/estacion/{slug} Metadata legacy
GET
/embed/{slug} Widget compacto
GET
/embed/{slug}/full Widget completo
GET
/play/{slug}.pls o .m3u Descarga de playlist
GET
/api/openapi.json Documento OpenAPI
Reglas de integración para cuidar la señal

Reglas de integración para cuidar la señal

No pongas secretos en el navegadorLa metadata pública no necesita token. La provisión y las operaciones de cuenta son privadas y requieren un Bearer token con alcance.
Usa cache y timeoutUna página pública no debe consultar cada segundo. Refresca con un intervalo razonable y conserva la última respuesta válida mientras reintentas.
Considera normal la metadata vacíaUna estación puede estar online sin título de canción o portada. Muestra un fallback claro sin romper todo el reproductor.
Mantén privadas las acciones administrativasLa API pública nunca enciende, detiene, edita ni elimina. Esas operaciones pertenecen a la API de provisión autenticada.

¿Necesitas provisión en lugar de metadata?

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.

Ver JSON de OpenAPI ↗ Hablar con soporte