meerkat-api

Node.js Wrapper for Meerkat API

This is a Node.js implementation of a wrapper for communicating with the Meerkat API.

Installation Instructions

npm install --save meerkat-api

Features

• There are two ways to use it:
  1. Callbacks: All methods take an optional callback function. The callback is called with two arguments: an error (or null if the operation succeeded) and an object containing the API data.
  2. Promises: If you don't supply a callback function, a Promise will be returned. If the operation completes successfully, the promise is resolved with the returned API data. If the operation fails, the promise is rejected with an error.
• Periodically queries Meerkat's Routing Map and modifies the API endpoints if they change.

Usage

var Meerkat = require('meerkat-api');

// Create an instance.
var meerkat = new Meerkat(API_TOKEN);
// You can get an API token here: http://developers.meerkatapp.co/api/

/**
 * General requests.
 */

// Callback style:
meerkat.getAllBroadcasts(function (err, broadcasts) {
    console.log(err || broadcasts);
});

// Promise style:
meerkat.getAllBroadcasts().
	then(function (broadcasts) {
		console.log(broadcasts);
	}, function (err) {
		console.log(err);
	});

// Callback style:
meerkat.getScheduledBroadcasts(function (err, broadcasts) {
    console.log(err || broadcasts);
});

// Promise style:
meerkat.getScheduledBroadcasts().
	then(function (broadcasts) {
		console.log(broadcasts);
	}, function (err) {
		console.log(err);
	});


/**
 * Broadcast-specific requests.
 */
var broadcastId = '6a4da7ba-20f5-4f0d-81de-e5cf37b3072b';

meerkat.getBroadcastSummary(broadcastId, function (err, summary) {
    console.log(err || summary);
});

meerkat.getBroadcastSummary(broadcastId).
	then(function (summary) {
		console.log(summary);
	}, function (err) {
		console.log(err);
	});

meerkat.getBroadcastActivities(broadcastId, function (err, activities) {
    console.log(err || activities);
});

meerkat.getBroadcastActivities(broadcastId).
	then(function (activities) {
		console.log(activities);
	}, function (err) {
		console.log(err);
	});

meerkat.getBroadcastRestreams(broadcastId, function (err, restreams) {
    console.log(err || restreams);
});

meerkat.getBroadcastRestreams(broadcastId).
	then(function (restreams) {
		console.log(restreams);
	}, function (err) {
		console.log(err);
	});

meerkat.getBroadcastComments(broadcastId, function (err, comments) {
    console.log(err || comments);
});

meerkat.getBroadcastComments(broadcastId).
	then(function (comments) {
		console.log(comments);
	}, function (err) {
		console.log(err);
	});

meerkat.getBroadcastLikes(broadcastId, function (err, likes) {
    console.log(err || likes);
});

meerkat.getBroadcastLikes(broadcastId).
	then(function (likes) {
		console.log(likes);
	}, function (err) {
		console.log(err);
	});

meerkat.getBroadcastWatchers(broadcastId, function (err, watchers) {
    console.log(err || watchers);
});

meerkat.getBroadcastWatchers(broadcastId).
	then(function (watchers) {
		console.log(watchers);
	}, function (err) {
		console.log(err);
	});


/**
 * User-specific requests.
 */
var userId = '54fb2e454d0000d23bb9c40f';

meerkat.getUserDetails(userId, function (err, userDetails) {
    console.log(err || userDetails);
});

meerkat.getUserDetails(userId).
	then(function (userDetails) {
		console.log(userDetails);
	}, function (err) {
		console.log(err);
	});


/**
 * Don't forget to clean up when exiting.
 */
process.on('SIGINT', shutdown);
process.on('SIGTERM', shutdown);

function shutdown () {

	// Don't accept any more requests. Finish handling the current requests.
	server.close(function () {
		meerkat.dispose();
	});
}