Node.js API for prowl, allowing to send PUSH notifications to your iPhone!
npm install node-prowlBe happy! Send push notifications to iDevices (iPad, iPhone etc) that
has the Prowl iPhone app installed. Simple,
easy and clean.
As of now this API supports push and only push.
npm install node-prowl
or put it in your package.json as usual and hit npm install. It depends
on xml2js and request.
The API requires your API-key, which could be found or created on the
"API Keys" tab on the Prowl website.
Initialize it with your key and start pushing!
``javascript
var Prowl = require('node-prowl');
var prowl = new Prowl('MY-API-KEY');
`
Now, use the prowl object whenever sending a push:
`javascript`
prowl.push('YO, this is awesomez!', 'My app', function( err, remaining ){
if( err ) throw err;
console.log( 'I have ' + remaining + ' calls to the api during current hour. BOOM!' );
});
You can provide more options to the PUSH notification:
`javascript``
prowl.push('YO, this is awesomez!', 'My app', {
providerkey: 'my-provider-key',
priority: 2,
url: 'http://revrise.com'
}, function( err, remaining ){
if( err ) throw err;
console.log( 'I have ' + remaining + ' calls to the api during current hour. BOOM!' );
});
I´d be happy if you wanted to contribute with pull requests or tips.
I´ll add you to the contributors list here and in the package.json file.
While contributing, make sure to write a test and make it pass if you
extend the library. Tests are written in the test directory, preferably
in all.js, since its quite small right now. It uses should.js and mocha
for tests.
Test by installing mocha and should.js (dev dependencies) and then just
hit:
PROWL_KEY=[my key here] make
And voila, it autotests for you.
Happily written during a four hour hack in my
apt in Chamonix, France.
* dxdc contributes with updated tests and fixed response errors
* paton contributes with callback fix
* mrose17 contributes with error handling fix
* Jellyfrog contributes with fixes
parameter bugs.
* Better error handling solving Issue
1