User Tools

Site Tools


webserviceinterface

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

webserviceinterface [2013/02/06 11:21]
131.246.191.249
webserviceinterface [2013/06/18 14:35] (current)
elyoliveira
Line 2: Line 2:
 ===== Web Service Interface ===== ===== Web Service Interface =====
  
-This page is under construction. We intend to specify here the web service interface used by all users and Flukso V2 devices to communicate with the mySmartGrid server.+This page is under construction. We intend to specify here the web service interface used by all users and software clients (including Flukso V2 devicesto communicate with the mySmartGrid server.
  
-The mySmartGrid API adopts the RESTful model, and therefore it relies on the HTTP protocol and the JSON standard. Regarding security, all the communication is performed over HTTPS, using a server certificate issued by the mySmartGrid CA. Additionally, both request and response bodies are encrypted using the device individual SHA-1 key, which only the server and the device know.+The mySmartGrid API adopts the RESTful model, and therefore relies on the HTTP protocol and the JSON standard.  
 + 
 +All the communication is performed over HTTPS, using a server certificate issued by the mySmartGrid CA. In addition, both request and response bodies are encrypted using the device individual SHA-1 key, which only the server and the device know.
  
 Despite some similarities, the mySmartGrid API is different from the Flukso.net API in many important aspects. So, if you want to switch from the Flukso.net platform to mySmartGrid, we strongly recomend you to flash the [[http://openwrt.mysmartgrid.de/flm02/atheros|latest mySmartGrid image]] to your device. Despite some similarities, the mySmartGrid API is different from the Flukso.net API in many important aspects. So, if you want to switch from the Flukso.net platform to mySmartGrid, we strongly recomend you to flash the [[http://openwrt.mysmartgrid.de/flm02/atheros|latest mySmartGrid image]] to your device.
Line 190: Line 192:
 == Sensor Measurements Registration == == Sensor Measurements Registration ==
  
-Reports sensor measurements to the server. The measurement values are saved in RRD files in Ws (Wattseconds).+Reports sensor measurements to the server. The measurement values are saved in RRD files in Wh (watt-hour).
  
 ^ Method       | POST                                                    | ^ Method       | POST                                                    |
Line 198: Line 200:
     measurements: [     measurements: [
       [ <unixtime - timestamp of the first measurement>,       [ <unixtime - timestamp of the first measurement>,
-        <integer  - consumed power in kW/h (ever increasing value), measured at the first timestamp> ],+        <integer  - consumed energy in Wh (ever increasing value), measured at the first timestamp> ],
       ...       ...
       [ <unixtime - timestamp of the measurement n>,       [ <unixtime - timestamp of the measurement n>,
-        <integer  - consumed power in kW/h (ever increasing value), measured at the timestamp n> ]+        <integer  - consumed energy in Wh (ever increasing value), measured at the timestamp n> ]
     ]     ]
   }   }
webserviceinterface.1360146083.txt.gz · Last modified: 2013/02/06 11:21 by 131.246.191.249