A Node.js module for using the PushBullet REST API.
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(deviceParams, noteTitle, noteBody, function(error, response) {
// response is the JSON response from the API
});
The push functions (note
, address
, list
, link
, file
) have a deviceParams
parameter which can be several types:
- If it is a string containing an '@' it is treated as an email address.
- If it is a string not containing an '@' it is treated as a device iden.
- If it is a number it is treated as a device id.
- If it is an object it is assumed to have one of the 'target parameters' as defined on https://docs.pushbullet.com/v2/pushes/ as an attribute. It can also have an optional
source_device_iden
attribute. If the object is empty,{}
, then the push is sent to all devices.
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.
Get the current user's information.
pusher.me(function(err, response) {});
Retrieves a list of pushable devices.
The options
parameter can use two attributes cursor
andlimit
to control the data returned.
cursor
is used to select the page if the results have been paginated.limit
is used to limit the number of objects in the reponse.
var options = {
limit: 10
};
pusher.devices(options, function(error, response) {});
Creates a new device.
pusher.createDevice('Device name', function(error, response) {});
Delete a device.
pusher.deleteDevice('u1qSJddxeKwOGuGW', function(error, response) {});
Retrieves a list of pushable contacts.
The options
parameter can use two attributes cursor
andlimit
to control the data returned.
cursor
is used to select the page if the results have been paginated.limit
is used to limit the number of objects in the reponse.
var options = {
limit: 10
};
pusher.contacts(options, function(error, response) {});
Create a contact.
pusher.createContact('Bob', 'bob@test.com', function(error, response) {});
Delete a contact.
pusher.deleteContact('ubdcjAfszs0Smi', function(error, response) {});
Push a note to the specified device.
pusher.note('u1qSJddxeKwOGuGW', 'New Note', 'Note body text', function(error, response) {});
Push an address to the specified device.
pusher.address('u1qSJddxeKwOGuGW', 'Fake Address', '10 Fake Street, Fakesville', function(error, response) {});
Push a list to the specified device.
var shoppingList = [
'steaks',
'sausages',
'burgers',
'buns',
'beer'
];
pusher.list('u1qSJddxeKwOGuGW', 'BBQ', shoppingList, function(error, response) {});
Push a link to the specified device.
pusher.link('u1qSJddxeKwOGuGW', 'GitHub', 'https://github.com/', function(error, response) {});
Push a file to the specified device.
pusher.file('u1qSJddxeKwOGuGW', '/path/to/file', 'Important file!', function(error, response) {});
Update a push.
Use to dismiss pushes or to update lists.
var updates = {
dismissed: true,
items: [
{
text: 'steaks',
checked: true
}
{
text: 'sausages',
checked: true
}
{
text: 'burgers',
checked: true
}
{
text: 'buns',
checked: true
}
{
text: 'beer',
checked: true
}
]
}
pusher.updatePush('udhrSpjAewzdwpCC', updates, function(error, response) {});
Delete a push.
pusher.deletePush('udhrSpjAewzdwpCC', function(error, response) {});
Get the push history.
The options
parameter can use three attributes cursor
, limit
and
modified_after
to control the data returned.
cursor
is used to select the page if the results have been paginated.limit
is used to limit the number of objects in the reponse.modified_after
should be a timestamp.
var options = {
limit: 10,
modified_after: 1400000000.00000
};
pusher.history(options, function(error, response) {})
Get a list of current subscriptions.
pusher.subscriptions(function(error, response) {});
Subscribe to a channel.
pusher.subscribe('jblow', function(error, response) {});
Subscribe to a channel.
pusher.unsubscribe('udprOsjAsLtNTRAG', function(error, response) {});
Get information about a channel.
pusher.channelInfo('jblow', function(error, response) {});
Returns a new stream listener which will emit events from the stream.
var stream = pusher.stream();
Connects to the stream.
stream.connect();
Disconnects from the stream.
stream.close();
Emitted when the stream has connected.
stream.on('connect', function() {
// stream has connected
});
Emitted when the stream has disconnected.
stream.on('close', function() {
// stream has disconnected
});
Emitted when there is a connection or streaming error.
stream.on('error', function(error) {
// stream error
});
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
});
Emitted when the keep-alive 'no-operation' message is received.
stream.on('nop', function() {
// nop message received
});
Emitted when the tickle
message is received.
stream.on('tickle', function(type) {
// tickle message received
});
Emited when the push
message is received.
stream.on('push', function(push) {
// push message received
});