myprowl

Prowl API Library for node

npm install myprowl
4 downloads in the last week
8 downloads in the last month

myprowl -- Prowl API Library for node

Description

Wrapper for Prowl's third-party API in version 2011-01-30

  • add
  • verify
  • create API keys

More info and API/Provider Key registration: https://www.prowlapp.com/

Install

  npm install myprowl

It`s simple

Add a notification with the required parameters.

var prowl = require('myprowl');
prowl.keys.setApikey("API-KEY");
prowl.add.simple("myApp","TestEvent","myDescription", function(error,response){
    if(!error){
        console.log("OK, remaining: "+response.success.remaining+
                    " , resetdate: "+response.success.resetdate);
    }else{
        console.log(error);
    }
});

Take Control

Add a notification with optional parameters.

var prowl = require('myprowl');
prowl.keys.setApikey("API-KEY");
prowl.add.complex({
        priority: 1,
        url: "http://nodejs.org",
        application: "TestApp",
        event: "TestEvent",
        description: "TestDescription"
    }, 
    function(error,response){
    if(!error){
        console.log("OK, remaining: "+response.success.remaining+
                    " , resetdate: "+response.success.resetdate);
    }else{
        console.log(error);
    }
});

Verify API keys

Verify an API key that is provided by a user.

var prowl = require('myprowl');
prowl.verify("USER-API-KEY",function(error,response){
    if(!error){
        console.log("valid");
        console.log(response);
    }else{
        console.log(error);
    }
});

Create API keys for users

Allow applications to create API keys for users.

1. Step: Get a registration token.

var prowl = require('myprowl');
prowl.keys.setProviderkey("Provider-KEY");
prowl.retrieve.token(function(error,response){
    if(!error){
        console.log("OK, remaining: "+response.success.remaining+
                    " , resetdate: "+response.success.resetdate);
        console.log("Token: "+response.retrieve.token);
        console.log("Redirect user to url: "+response.retrieve.url);
    }else{
        console.log(error);
    }
});

2. Step: Get the key.

var prowl = require('myprowl');
prowl.keys.setProviderkey("Provider-KEY");
prowl.retrieve.apikey("TOKEN",function(error,response){
    if(!error){
        console.log("OK, remaining: "+response.success.remaining+
                    " , resetdate: "+response.success.resetdate);
        console.log("API key: "+response.retrieve.apikey);
    }else{
        console.log(error);
    }
});

Methods

keys.setApikey(key)

Set the API Key for your application. The key is used for the add API calls.

  • key - 40-byte hexadecimal string or multiple keys separated by commas.

keys.setProviderkey(key)

Set the Provider Key for your application. The provider key is used for all API calls.

  • key - 40-byte hexadecimal string.

add.simple(app,event,description,callback)

  • app - Name of the application. [256 chars]
  • event - Name of the event or the subject. [1024 chars]
  • description - Description [10000 chars]
  • callback - callback(error,response)

add.complex(options,callback)

  • options
    • priority - Notification priority. [-2,2] (Optional)
    • url - URL which will be attached to the notification. [512 chars] (Optional)
    • app - Name of the application. [256 chars]
    • event - Name of the event or the subject. [1024 chars]
    • description - Description [10000 chars]
  • callback - callback(error,response)

retrieve.token(callback)

  • callback - callback(error,response)

retrieve.apikey(token,callback)

  • token - Token returned from retrieve.token.
  • callback - callback(error,response)
npm loves you