order.png

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.