API Cosm: Feeds

Siguiendo sobre la plataforma OpenData Cosm veremos el concepto de Feed en su API:

¿Qué es un feed?

Un Feed es un entorno que representa un grupo de datastreams con un conjunto de atributos (algunos obligatorios, otros opcionales):

Un datastream representa el stream de un sensor/dispositivo dentro de un entorno y contiene los siguientes atributos (algunos obligatorios, otros opcionales):

Desde el API podemos:

– Crear un Feed: se usa el método POST para crear el FEED pasando en la cabecera nuestra Api Key, devuelve la URL del feed creado:

Por ejemplo:

 >curl --request POST --data-binary @datafile.txt --header "X-ApiKey: YOUR_API_KEY_HERE" http://api.cosm.com/v2/feeds
 Donde datafile.txt tiene este contenido:
 

– Actualizar un Feed: se usa el método PUT para trabajar sobre un Feed ya creado:

En el ejemplo anterior mi feed sería por ejemplo:: http://api.cosm.com/v2/feeds/1977 y para actualizarlo:

 > curl --request PUT --data-binary @datafile.txt --header "X-ApiKey: YOUR_API_KEY_HERE" http://api.cosm.com/v2/feeds/1977

– Listar todos los Feeds: se consulta por GET y devuelve una lista de páginas visibles por una cuenta autenticada.

 > curl --request GET --header "X-ApiKey: YOUR_API_KEY_HERE" "http://api.cosm.com/v2/feeds?lat=51.52&lon=0.13&distance=100.0&q=energy"

– Ver un Feed: se pide por GET el valor de un Feed:

 >curl --request GET --header "X-ApiKey: YOUR_API_KEY_HERE" "http://api.cosm.com/v2/feeds/504.json?datastreams=0,1,2"

– Borrar un Feed: se pide por POST y se indica el Feed a borrar

 >curl --request DELETE --header "X-ApiKey: YOUR_API_KEY_HERE" http://api.cosm.com/v2/feeds/1977

– Feeds Móviles: permite indicar el histórico a almacenar de un Feed:

>http://api.cosm.com/v2/feeds/3819.json?duration=1day