PushBullet API

A Node.js module for using the PushBullet REST API.

Usage

This module is very simple to use. All you need is your PushBullet API key and you can begin pushing.

var PushBullet = require('pushbullet');
var pusher = new PushBullet('YOUR-API-KEY');

pusher.devices(function(error, response) {
    // response is the JSON response from the API
});

pusher.note(deviceIden, noteTitle, noteBody, function(error, response) {
    // response is the JSON response from the API
});

Both device IDENs and device IDs can be used. If the deviceIden parameter is passed as a number it is treated as a device ID.

Callbacks

Each callback receives two arguments. For a successful request the first argument will be null or undefined and the second argument will be the parsed JSON response from the API.

If an error occurs at any part of the request the first argument will be an Error object.

API

PushBullet.me(callback);

Get the current user's information.

pusher.me(function(err, response) {});

PushBullet.devices(callback)

Retrieves a list of pushable devices.

pusher.devices(function(error, response) {});

PushBullet.createDevice(nickname, callback)

Creates a new device.

pusher.createDevice('Device name', function(error, response) {});

PushBullet.deleteDevice(deviceIden, callback)

Delete a device.

pusher.deleteDevice('u1qSJddxeKwOGuGW', function(error, response) {});

PushBullet.contacts(callback)

Retrieves a list of pushable contacts.

pusher.contacts(function(error, response) {});

PushBullet.deleteContact(contactIden, callback)

Delete a contact.

pusher.deleteContact('ubdcjAfszs0Smi', function(error, response) {});

PushBullet.note(deviceIden, noteTitle, noteBody, callback)

Push a note to the specified device.

pusher.note('u1qSJddxeKwOGuGW', 'New Note', 'Note body text', function(error, response) {});

PushBullet.address(deviceIden, name, address, callback)

Push an address to the specified device.

pusher.address('u1qSJddxeKwOGuGW', 'Fake Address', '10 Fake Street, Fakesville', function(error, response) {});

PushBullet.list(deviceIden, name, listItems, callback)

Push a list to the specified device.

var shoppingList = [
    'steaks',
    'sausages',
    'burgers',
    'buns',
    'beer'
];
pusher.list('u1qSJddxeKwOGuGW', 'BBQ', shoppingList, function(error, response) {});

PushBullet.link(deviceIden, name, url, callback)

Push a link to the specified device.

pusher.link('u1qSJddxeKwOGuGW', 'GitHub', 'https://github.com/', function(error, response) {});

PushBullet.file(deviceIden, filePath, message, callback)

Push a file to the specified device.

pusher.file('u1qSJddxeKwOGuGW', '/path/to/file', 'Important file!', function(error, response) {});

PushBullet.deletePush(pushIden, callback)

Delete a push.

pusher.deletePush('udhrSpjAewzdwpCC', function(error, response) {});

PushBullet.history(options, callback)

Get the push history.

The options parameter can use two attributes modified_after and cursor to control the data returned.

• modified_after should be a timestamp.
• cursor is used to select the page if the results have been paginated.

var options = {
    modified_after: 1400000000.00000
}

pusher.history(options, function(error, response) {})

PushBullet.stream()

Returns a new stream listener which will emit events from the stream.

var stream = pusher.stream();

connect()

Connects to the stream.

stream.connect();

close()

Disconnects from the stream.

stream.close();

Events

connect

Emitted when the stream has connected.

stream.on('connect', function() {
    // stream has connected
});

close

Emitted when the stream has disconnected.

stream.on('close', function() {
    // stream has disconnected
});

error

Emitted when there is a connection or streaming error.

stream.on('error', function(error) {
    // stream error
});

message

Emitted when a message is received from the stream. message will be emitted for all messages but you can listen for specific messages with nop, tickle and push.

stream.on('message', function(message) {
    // message received
});

nop

Emitted when the keep-alive 'no-operation' message is received.

stream.on('nop', function() {
    // nop message received
});

tickle

Emitted when the tickle message is received.

stream.on('tickle', function(type) {
    // tickle message received
});

push

Emited when the push message is received.

stream.on('push', function(push) {
    // push message received
});