#nodeGauges

NodeJS API wrapper for Guag.es.

All API Methods Supported

• Your Information
• API Clients
• Gauges
• Sharing
• Content
• Referrers
• Traffic
• Resolutions
• Technology
• Search Terms
• Search Engines
• Locations

#Installation

####Option 1 - Install From NPM

1. Run npm install node-gauges in Terminal.
2. Include the code in your app…

var nodeGauges = require('node-gauges').createClient('API_KEY');

####Option 2 - Install From Git Repositry

1. Clone the repository git clone git://github.com/bencevans/node-gauges.git
2. Include the code in your app…

var nodeGauges = require('/path/to/cloned/repo/lib/nodeGauges.js').createClient('API_KEY');

#Usage

####Get Your Information (GET /me) - Gaug.es Docs

nodeGauges.me(callback);

• callback (function) - Returns API Data in the format callback(err, data, responce);

nodeGauges.me(function (err, data) {
	if(err)
		console.log('Error: ' + err);
	else
		console.log(data);
});

####Update Your Information (PUT /me) - Gaug.es Docs

nodeGauges.me(parameters, callback);

• parameters (object) - All Paramaters can be seen on the Gauge.es API Page
• callback (function) - Returns API Data in the format callback(err, data, responce);

nodeGauges.me({
	first_name:"Bob",
	last_name:"Marley"	
}, function (err, data) {
	if(err)
		console.log('Error: ' + err);
	else
		console.log(data);
});

####API Client List (GET /clients) - Gaug.es Docs

nodeGauges.clients(callback);

• callback (function) - Returns API Data in the format callback(err, data, responce);

nodeGauges.clients(function (err, data) {
	if(err)
		console.log('Error: ' + err);
	else
		console.log(data);
});

####Create an API Client (POST /clients) - Gaug.es Docs

nodeGauges.clients.create(parameters, callback);

• parameters (object) - All Paramaters can be seen on the Gauge.es API Page
• callback (function) - Returns API Data in the format callback(err, data, responce);

nodeGauges.clients.create({
	description: "nodeGauges Test"
}, function (err, data) {
	if(err)
		console.log('Error: ' + err);
	else
		console.log(data);
});

####Delete an API Client (DELETE /clients/:id) - Gaug.es Docs

nodeGauges.clients.delete(clientID, callback);

• clientID (string) - Client Identifier/Key
• callback (function) - Returns API Data in the format callback(err, data, responce);

nodeGauges.clients.delete('CLIENT_KEY', function (err, data) {
	if(err){
		console.log('Error: ' + err);
	} else{
		console.log(data);
	}
});

####Gauges List (GET /gauges) - Gaug.es Docs

nodeGauges.gauges(callback);

• callback (function) - Returns API Data in the format callback(err, data, responce);

nodeGauges.gauges('GAUGE_ID', function (err, data) {
	if(err){
		console.log('Error: ' + err);
	} else{
		console.log(data);
	}
});

####Create a New Gauge (POST /gauges) - Gaug.es Docs

nodeGauges.gauges.create(parameters, callback);

• parameters (object) - All Paramaters can be seen on the Gauge.es API Page
• callback (function) - Returns API Data in the format callback(err, data, responce);

nodeGauges.gauges.create({
	title:"Test Gauge",
	tz:"London"
}, function (err, data) {
	if(err){
		console.log('Error: ' + err);
	} else{
		console.log(data);
	}
});

####Gauge Details (GET /gauges/:id) - Gaug.es Docs

nodeGauges.gauges(gaugeID, callback);

• gaugeID (string) - Gauge Identifier
• callback (function) - Returns API Data in the format callback(err, data, responce);

nodeGauges.gauges('GAUGE_ID', function (err, data) {
	if(err){
		console.log('Error: ' + err);
	} else{
		console.log(data);
	}
});

####Update a Gauge (PUT /gauges/:id) - Gaug.es Docs

nodeGauges.gauges.update(gaugeID, callback);

• gaugeID (string) - Gauge Identifier
• callback (function) - Returns API Data in the format callback(err, data, responce);

nodeGauges.gauges.update('GAUGE_ID', function (err, data) {
	if(err){
		console.log('Error: ' + err);
	} else{
		console.log(data);
	}
});

####Delete a Gauge (DELETE /gauges/:id) - Gaug.es Docs

nodeGauges.gauges.delete(gaugeID, callback);

• gaugeID (string) - Gauge Identifier
• callback (function) - Returns API Data in the format callback(err, data, responce);

nodeGauges.gauges.delete('GAUGE_ID', function (err, data) {
	if(err){
		console.log('Error: ' + err);
	} else{
		console.log(data);
	}
});

####List Shares (GET /gauges/:id/shares) - Gaug.es Docs

nodeGauges.sharing(gaugeID, callback);

• gaugeID (string) - Gauge Identifier
• callback (function) - Returns API Data in the format callback(err, data, responce);

nodeGauges.sharing('GAUGE_ID', function (err, data) {
	if(err){
		console.log('Error: ' + err);
	} else{
		console.log(data);
	}
});

####Share Gauge (POST /gauges/:id/shares) - Gaug.es Docs

nodeGauges.sharing.share(gaugeID, email, callback);

• gaugeID (string) - Gauge Identifier
• email (string) - Email of the person you wish to share the gauge with
• callback (function) - Returns API Data in the format callback(err, data, responce);

nodeGauges.sharing.share('GAUGE_ID', '[email protected]', function (err, data) {
	if(err){
		console.log('Error: ' + err);
	} else{
		console.log(data);
	}
});

####UnShare Gauge (DELETE /gauges/:id/shares/:user_id) - Gaug.es Docs

nodeGauges.sharing.unshare(gaugeID, userID, callback);

• gaugeID (string) - Gauge Identifier
• userID (string) - This can be found by using the nodeGauges.sharing method.
• callback (function) - Returns API Data in the format callback(err, data, responce);

nodeGauges.sharing.unshare('GAUGE_ID', 'USERID', function (err, data) {
	if(err){
		console.log('Error: ' + err);
	} else{
		console.log(data);
	}
});

####Content (GET /gauges/:id/content) - Gaug.es Docs

nodeGauges.content(gaugeID, [parameters,] callback);

• gaugeID (string) - Gauge Identifier
• parameters (object) - Optional - All Paramaters can be seen on the Gauge.es API Page
• callback (function) - Returns API Data in the format callback(err, data, responce);

nodeGauges.gauges.content('GAUGE_ID', function (err, data) {
	if(err){
		console.log('Error: ' + err);
	} else{
		console.log(data);
	}
});

####Referrers (GET /gauges/:id/referrers) - Gaug.es Docs

nodeGauges.referrers(gaugeID, [parameters,] callback);

• gaugeID (string) - Gauge Identifier
• parameters (object) - Optional - All Paramaters can be seen on the Gauge.es API Page
• callback (function) - Returns API Data in the format callback(err, data, responce);

nodeGauges.gauges.referrers('GAUGE_ID', function (err, data) {
	if(err){
		console.log('Error: ' + err);
	} else{
		console.log(data);
	}
});

####Traffic (GET /gauges/:id/traffic) - Gaug.es Docs

nodeGauges.traffic(gaugeID, [parameters,] callback);

• gaugeID (string) - Gauge Identifier
• parameters (object) - Optional - All Paramaters can be seen on the Gauge.es API Page
• callback (function) - Returns API Data in the format callback(err, data, responce);

nodeGauges.gauges.traffic('GAUGE_ID', function (err, data) {
	if(err){
		console.log('Error: ' + err);
	} else{
		console.log(data);
	}
});

####Resolutions (GET /gauges/:id/resolutions) - Gaug.es Docs

nodeGauges.resolutions(gaugeID, [parameters,] callback);

• gaugeID (string) - Gauge Identifier
• parameters (object) - Optional - All Paramaters can be seen on the Gauge.es API Page
• callback (function) - Returns API Data in the format callback(err, data, responce);

nodeGauges.gauges.resolutions('GAUGE_ID', function (err, data) {
	if(err){
		console.log('Error: ' + err);
	} else{
		console.log(data);
	}
});

####Technology (GET /gauges/:id/technology) - Gaug.es Docs

nodeGauges.technology(gaugeID, [parameters,] callback);

• gaugeID (string) - Gauge Identifier
• parameters (object) - Optional - All Paramaters can be seen on the Gauge.es API Page
• callback (function) - Returns API Data in the format callback(err, data, responce);

nodeGauges.gauges.technology('GAUGE_ID', function (err, data) {
	if(err){
		console.log('Error: ' + err);
	} else{
		console.log(data);
	}
});

####Search Terms (GET /gauges/:id/terms) - Gaug.es Docs

nodeGauges.terms(gaugeID, [parameters,] callback);

• gaugeID (string) - Gauge Identifier
• parameters (object) - Optional - All Paramaters can be seen on the Gauge.es API Page
• callback (function) - Returns API Data in the format callback(err, data, responce);

nodeGauges.gauges.terms('GAUGE_ID', function (err, data) {
	if(err){
		console.log('Error: ' + err);
	} else{
		console.log(data);
	}
});

####Search Engines (GET /gauges/:id/engines) - Gaug.es Docs

nodeGauges.engines(gaugeID, [parameters,] callback);

• gaugeID (string) - Gauge Identifier
• parameters (object) - Optional - All Paramaters can be seen on the Gauge.es API Page
• callback (function) - Returns API Data in the format callback(err, data, responce);

nodeGauges.gauges.engines('GAUGE_ID', function (err, data) {
	if(err){
		console.log('Error: ' + err);
	} else{
		console.log(data);
	}
});

####Locations (GET /gauges/:id/locations) - Gaug.es Docs

nodeGauges.locations(gaugeID, [parameters,] callback);

• gaugeID (string) - Gauge Identifier
• parameters (object) - Optional - All Paramaters can be seen on the Gauge.es API Page
• callback (function) - Returns API Data in the format callback(err, data, responce);

nodeGauges.gauges.locations('GAUGE_ID', function (err, data) {
	if(err){
		console.log('Error: ' + err);
	} else{
		console.log(data);
	}
});