Added gethomecoachsdata API call (#28)

Author: Pierre M

netatmo.js

@@ -93,7 +93,7 @@ netatmo.prototype.authenticate = function (args, callback) {
   password = args.password;
   client_id = args.client_id;
   client_secret = args.client_secret;
-  scope = args.scope || 'read_station read_thermostat write_thermostat read_camera';
+  scope = args.scope || 'read_station read_thermostat write_thermostat read_camera read_homecoach';
 
   var form = {
     client_id: client_id,
@@ -866,4 +866,53 @@ netatmo.prototype.getCameraPicture = function (options, callback) {
   return this;
 };
 
+/**
+ * https://dev.netatmo.com/dev/resources/technical/reference/healthyhomecoach/gethomecoachsdata
+ * @param options
+ * @param callback
+ * @returns {*}
+ */
+netatmo.prototype.getHealthyHomeCoachData = function (options, callback) {
+  // Wait until authenticated.
+  if (!access_token) {
+    return this.on('authenticated', function () {
+      this.getHealthyHomeCoachData(options, callback);
+    });
+  }
+
+  if (options != null && callback == null) {
+    callback = options;
+    options = null;
+  }
+
+  var url = util.format('%s/api/gethomecoachsdata?access_token=%s', BASE_URL, access_token);
+  if (options != null) {
+    url = util.format(url + '&device_id=%s', options.device_id);
+  }
+
+  request({
+    url: url,
+    method: "GET",
+  }, function (err, response, body) {
+    if (err || response.statusCode != 200) {
+      return this.handleRequestError(err, response, body, "getHealthyHomeCoachData error");
+    }
+
+    body = JSON.parse(body);
+
+    var devices = body.body.devices;
+
+    this.emit('get-healthhomecoaches-data', err, devices);
+
+    if (callback) {
+      return callback(err, devices);
+    }
+
+    return this;
+
+  }.bind(this));
+
+  return this;
+};
+
 module.exports = netatmo;

test.js

@@ -247,3 +247,12 @@ var options = {
 };
 
 api.getCameraPicture(options);
+
+// Get Healthy Home Coach Data
+// See docs: https://dev.netatmo.com/dev/resources/technical/reference/healthyhomecoach/gethomecoachsdata
+var options = {
+  device_id: '',
+};
+
+api.getHealthyHomeCoachData(options);
+