flower-power-api

A node.js module to interface with the cloud service for the Parrot Flower Power.

Get your access API

• username password
  • Make sure you have an account created by your smartphone. You should be see your garden: myflowerpower.parrot.com.
• client_id client_secret
  • Sign up to API here, and got by email your Access ID (client_id) and your Access secret (client_secret).

API

Install

$ npm install flower-power-api

Load

var FlowerPowerApi = require('flower-power-api');
var api = new FlowerPowerApi();

Login to cloud

var credential = {
    'username'		: "...",
    'password'		: "...",
    'client_id'		: "...",
    'client_secret'	: "...",
    'auto-refresh'	: false
};
 
api.login(credential, function(err, res) {
    if (err) console.log(err);
    else {
        // Head in the clouds :)
    }
});

Get garden configuration (and specials methods)

api.getGarden(function(error, garden));

Communicate with Cloud

Every method have the sema pattern:

// For example:
'methodName': {method: 'GET/json', path: '/im/a/flower/', auth: true}
// Call like this:
api.methodName([data,] callback);
 
// 'data' is optional, 'callback' is required
data = {
    url: {}
    param1,
    param2,
    ...
}
callback = function(error, results);

// Find all methods in ./FlowerPowerCloud.js
var api = {
    // Profile
    'login': {method: 'POST/urlencoded', path: '/user/v2/authenticate', auth: false},
    'refresh': {method: 'POST/urlencoded', path: '/user/v2/authenticate', auth: false},
    'getProfile': {method: 'GET/json', path: '/user/v4/profile', auth: true},
    'getUserVersions': {method: 'GET/json', path: '/user/v1/versions', auth: true},
 
    // Garden
    'getSyncGarden': {method: 'GET/json', path: '/sensor_data/v4/garden_locations_status', auth: true},
    'sendSamples': {method: 'PUT/json', path: '/sensor_data/v5/sample', auth: true},
    'getSyncData': {method: 'GET/json', path: '/sensor_data/v3/sync', auth: true},
    'getFirmwareUpdate': {method: 'GET/json', path: '/sensor_data/v1/firmware_update', auth: true},
    'getLocationSamples': {method: 'GET/json', path: '/sensor_data/v2/sample/location/:location_identifier', auth: true},
    'getStatistics': {method: 'GET/json', path: '/sensor_data/v1/statistics/:location_identifier', auth: true},
 
    // Images
    'getImageLocation': {method: 'GET/json', path: '/image/v3/location/user_images/:location_identifier', auth: true},
};
 

Param in url

// Api which need parameters into url
'anExample': {method: 'GET/json', path: '/:this/is/an/:example'}
 
api.anExample({
    url: {
        this: 'flower',
        example: 'organ'
    },
    param1: '...',
    param2: '...'
}, callback);
 
// Become
'/flower/is/an/organ'

Finally

Enjoy!