Retro Radio API v1

1. Introducción

Retro Radio ofrece a sus usuarios y a los desarrolladores una API REST limitada de solo lectura para que puedan realizar aplicaciones utilizando nuestra gran colección de radios. Esta API es gratuita y de libre uso y no requiere registrarse. No se garantiza que, por abusos o cualquier motivo de fuerza mayor, se restringa parcial o totalmente su acceso.

2. Como usar la API

Como se ha dicho anteriormente es de solo lectura, por lo que todas las peticiones son GET. Las respuestas siempre se devuelven en formato JSON. Veamos un ejemplo y analicemos cada elemento:

{
  "nombre": "los40classic",
  "nomlargo": "Los 40 Classic [M80 Radio]",
  "genero": "Oldies",
  "dirweb": "https://playerservices.streamtheworld.com/api/livestream-redirect/LOS40_CLASSIC_SC#.mp3"
}

nombre - Es un identificador único compuesto exclusivamente de letras minusculas y numeros y que se usa en el parámetro ?id= para llamada a la API.
nomlargo - Es el nombre de la radio. Algunas emisoras tienen entre corchetes la antigua denominación de la emisora, para que las personas sepan exactamente que emisora es.
genero - El género de la emisora
dirweb - la URL directa al streaming de la emisora

Hay dos formas de hacerlo:

2.1. Petición conociendo el identificador

Si se quiere obtener solo una emisora, simplemente tendremos que especificar a través del parametro ?id= el dentificador de la emisora (recuerda que es nombre)

GET https://radio.swey.net/api/v1/radio.php?id=los40classic

2.2. Petición para conocer todas las emisoras

Para obtener todas las emisoras, no se especifica ningún identificador.

GET https://radio.swey.net/api/v1/radio.php