Merge pull request robertogallea#20 from pimhofman/savingsreport

Get energy savings report

Author: robertogallea

README.md

@@ -125,6 +125,7 @@ Currently these methods are supported:
 - isAnyoneAtHome($access_token);
 - getPresenceLock($access_token);
 - setPresenceLock($access_token, $settings);
+- getEnergySavingsReport($access_token, $year, $month, $country_code);
 - deleteEnergyIQMeterReading($access_token, $reading_id);
 - addEnergyIQMeterReading($access_token, $settings);
 - updateEnergyIQTariff($access_token, $settings);
@@ -133,6 +134,9 @@ Currently these methods are supported:
 - getEnergyIQ($access_token);
 - getAppUsersRelativePositions($token)
 
+# Country code format for getEnergySavingsReport
+To request an energy savings report via getEnergySavingsReport, you're required to pass a three-letter country code in accordance with [ISO 3166-1 alpha-3](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3)
+
 ## 6. Issues, Questions and Pull Requests
 
 You can report issues and ask questions in the [issues section](https://github.com/robertogallea/restado/issues). Please start your issue with `ISSUE: ` and your question with `QUESTION: `

src/Restado.php

@@ -896,6 +896,27 @@ public function deleteEnergyIQMeterReading($access_token, $reading_id) {
         return json_decode($response->getBody());
     }
 
+    /**
+     * @param $access_token
+     * @param $year
+     * @param $month
+     * @param $country_code
+     * @return mixed
+     */
+    public function getEnergySavingsReport($access_token, $year, $month, $country_code) {
+        $provider = $this->getProvider();
+        $home_id = $this->getHomeId();
+
+        $request = $provider->getAuthenticatedRequest(
+            'GET',
+            'https://energy-bob.tado.com/' .  $home_id . '/' . $year . '-' . $month . '?country=' . $country_code,
+            $access_token
+        );
+        $client = new \GuzzleHttp\Client();
+        $response = $client->send($request);
+        return json_decode($response->getBody());
+    }
+    
     /**
      * @return GenericProvider
      */