XML Interfaz de Radiostream™
Para el control de sus propias aplicaciones
Esta guía describe el uso de la Radiostream™ interfaz de XML para gestionar su servidor de streaming desde sus propias aplicaciones utilizando un ejemplo concreto para PHP.
Interfaz XML
URL de la interfaz
La interfaz es accesible en la dirección https://www.radiostream.de/api {SSL}
Estructura del XML
Las XML solicitudes, que estan enviadas a Radiostream™, son siempre de la siguiente manera:
La declaración ((class="servidor")) se establece, y significa que el servidor que desea controlar. En el futuro otras clases podrán ser complementada, pero no existen en la actualidad. Un valor distinto de servidor? aquí no está permitido.
El tipo method? es el método en el servidor para abrir lo. En este ejemplo, el método start? quiere decir inicé servidor.
Los valores username y password corresponden a sus datos de acceso de Radiostream™ {número de cliente o dirección de correo electrónico y su contraseña de acceso}.
Así de fácil: El ejemplo anterior es un ejemplo para iniciar el servidor.
La estructura de las XML respuestas
Las respuestas son las siguientes:
El atributo de estado status contiene, en función del éxito o el fracaso del llamado comando success o failed como un valor de retorno. Además, hay un tercer valor de retorno de error? una llamada de solicitud que indica una solicitud falsa. La diferencia entre failed? y error?: Así que es un failed? no fue pedido sintácticamente correcta, pero sin resultado satisfactorio. Un error? indica una solicitud de error.
En el margenmessage? hay también un mensaje verbal.
Métodos
Además de start del ejemplo arriba, otros métodos están disponibles. Esta es la lista actual de los métodos exigible y sus parámetros, si es necesario.
En todas las solicitudes debe la especificación de username? y password?.
- start: Inicia el servidor
: stop: Detiene el servidor
: sourcestatus
- Muestra el estado del servidor
- streamstatus
- Muestra el estado de los arroyos, incluyendo el nombre del servidor, número de oyentes, el título de la canción, el promedio de tiempo de escucha etc.
- kicksource
- Se desconecta el programa del servidor por ejemplo, para el cambio de moderadors
- links
- Muestra todas las conexiones, URL, gráficos estado o un jugador para incrustar enlaces en su página de inicio
Ejemplo 1: cambiar de servidor
Solicitud
Respuesta
Ejemplo 2: estado de flujo
Solicitud
Respuesta
Ejemplo PHP
Este ejemplo es de PHP en PHP4 y PHP5 disponible.
Instalar Paquete PEAR "XML_Serializer"
Ejecuta en su sistema el siguiente comando:
Si el paquete ya está instalado en el servidor, recibirá el siguiente mensaje:
Ignoring installed package pear/XML_Serializer
Nothing to install
A continuación, proceder como se indica.
Clase PHP de Radiostream™
Descargue el siguiente archivo en su servidor y extraer la clase de PHP class.xml-radiostream.php en el directorio web.
http://www.radiostream.de/radiostream-xml.zip
Insertar código
El siguiente ejemplo muestra la integración de código de programa en su propia secuencia de comandos:
Si la siguiente salida:
Para las solicitudes de prórroga, escriba a admin@radiostream.de.
