node-winkapi

A node.js module to interface with the QuirkyWink API.

Before Starting

You will need OAuth tokens and a Wink account:

• To get the OAuth tokens:

  • Make sure you have a Quirky account; if not, go to quirky.com and click on SIGN UP (in the upper right-hand corner).

  • Send an email to questions@quirky.com and request access to the Wink API.

• To get a Wink account:

  • Attach a Wink-capable device to your network.

  • Launch either the iOS or Android app on your smart phone/tablet.

  • Follow the directions to create an account.

Install

npm install winkapi

API

Load

var WinkAPI = require('node-winkapi');

Login to cloud

var clientID = '...'
, clientSecret = '...'
, userName = '...'
, passPhrase = '...'
, winkapi
;
winkapi = new WinkAPI.WinkAPI({ clientID : clientID
, clientSecret : clientSecret }).login(userName, passPhrase, function(err) {
if (!!err) return console.log('login error: ' + err.message);
// otherwise, good to go!
}).on('error', function(err) {
console.log('background error: ' + err.message);
});

Get/Set user information

winkapi.getUser(function(err, user) {
if (!!err) return console.log('getUser: ' + err.message);
// inspect user{}
});
winkapi.setUser({ name: '...' }, function(err, user) {
if (!!err) return console.log('setUser: ' + err.message);
// inspect user{}
});

Get/Set device information

winkapi.getDevices(function(err, devices) {
if (!!err) return console.log('getDevices: ' + err.message);
// inspect devices[{}]
});
winkapi.getDevice(device, function(err, device) {
if (!!err) return console.log('getDevice: ' + err.message);
// inspect device{}
});
winkapi.setDevice(device, { name: ... }, function(err, device) {
if (!!err) return console.log('setDevice: ' + err.message);
// inspect device{}
});

Get icon information

winkapi.getIcons(function(err, icons) {
if (!!err) return console.log('getIcons: ' + err.message);
// inspect icons[{}]
});

Get channel information

winkapi.getChannels(function(err, channels) {
if (!!err) return console.log('getChannels: ' + err.message);
// inspect channels[{}]
});
winkapi.getDialTemplates(function(err, dialTemplates) {
if (!!err) return console.log('getDialTemplates: ' + err.message);
// inspect dialTemplates[{}]
});

Get/Set linked service information

winkapi.getServices(function(err, services) {
if (!!err) return console.log('getServices: ' + err.message);
// inspect services[{}]
});
winkapi.newService({ service: '...', account: '...' }, function(err, service) {
if (!!err) return console.log('setService: ' + err.message);
// inspect service{}
});

Get/Set trigger information

winkapi.getTrigger(id, function(err, trigger) {
if (!!err) return console.log('getTrigger: ' + err.message);
// inspect trigger{}
});
winkapi.setTrigger('1', { enabled: true }, function(err, trigger) {
if (!!err) return console.log('setTrigger: ' + err.message);
// inspect trigger{}
});

Get/Set dial-related information

winkapi.getDialTemplates(function(err, dialTemplates) {
if (!!err) return console.log('getDialTemplates: ' + err.message);
// inspect dialTemplates[{}]
});
winkapi.setDial(dial, { enabled: true }, function(err, dial) {
if (!!err) return console.log('setDial: ' + err.message);
// inspect dial{}
});
winkapi.setDialValue(dial, value, callback) {
if (!!err) return console.log('setDialValue: ' + err.message);
// inspect dial{}
}
winkapi.setDialLabels(dial, mainLabel, secondaryLabel, callback) {
if (!!err) return console.log('setDialLabels: ' + err.message);
// inspect dial{}
}

Set outlet-related information

winkapi.setOutlet(outlet, { powered: true }, function(err, outlet) {
if (!!err) return console.log('setOutlet: ' + err.message);
// inspect outlet{}
});

For the Future

• Sharing
• Alarms
• Schedules

Finally

Enjoy!