A JavaScript SDK-like implementation to assist work with the NetSapiens API

Configuration
To construct an instance of the api connector, a configuration JSON file must be loaded into or a JS object coded into your application script.

var configuration = {
  "clientName": "My Awesome Application", // A name for your app
  "clientId": "omp@localhost", // Oauth client_id value
  "clientSecret": "b27c3efdab5b5377d843626fd6a2e313", // Oauth client_secret value *** OPTIONAL - SEE BELOW ***
  "server": "netsapiens.com", // FQDN of the server where your api is installed
}

*** You can also chose to not expose the client secret, simply leave it out of the configuration object and contact netsapiens for further instructions on how to accomplish this.

Constructor

var api = new netsapiens.API(configuration);

Instance Methods

requestAccess(user, password);
post(args, callback, errorCallBack, url);

Events

access
Fired when a successful (200) response is received to a requestAccess() call.

on('access', function(){});

access-denied
Fired when an unsuccessful (400-500) response is received to a requestAccess() call.

on('access-denied', function(){});

access-expired
Fired when the access token in localStorage has expired.

on('access-expired', function(){});

netsapiens.js uses npm scripts as the primary build task runner.

npm scripts can be viewed in package.json "scripts" configuration.

Linting source code:

$ npm run lint 

runs jshint on all js files in ./src directory.

Testing source code:

$ npm test 

runs all unit tests in test directory using mocha module. https://mochajs.org/

Build distribution packages:

$ npm run build

builds both the netsapiens.js and netsapiens.min.js files with version. runs lint and test scripts before building the files.

$ npm run build:js-min

builds minified only.

$ npm run build:js-full

builds full javascript only.

See npm documentation for further depth: https://docs.npmjs.com/cli/version

$ npm version major|minor|patch
$ npm publish
$ git push origin master
$ git push origin --tags

https://api.netsapiens.com/ns-api/webroot/apidoc/