@plusauth/plusauth-rest-js

@plusauth/plusauth-rest-js

Helper library for interacting with PlusAuth REST API intent upon to be used in NodeJS and browser environments.

Table Of Content

1. Installation
2. Usage
3. Docs
4. Examples

Installation

From PlusAuth CDN:

<!-- Latest release -->
<script src="https://unpkg.com/@plusauth/plusauth-rest-js@0.7.0-beta.0/dist/plusauth-rest-js.min.js"></script>

With npm:

$ npm install @plusauth/plusauth-rest-js

or with yarn

$ yarn add @plusauth/plusauth-rest-js

Usage

CDN Usage

The library will be exposed to global as PlusAuthRestClient

Initialize it like following:

const authToken = '<ACCESS_TOKEN>'
const plusAuth = new PlusAuthRestClient('https://<YOUR_TENANT_ID>.plusauth.com', { token: authToken })

NPM Usage

import PlusAuthRestClient from '@plusauth/plusauth-rest-js'

const authToken = '<ACCESS_TOKEN>'
const plusAuth = new PlusAuthRestClient('https://<YOUR_TENANT_ID>.plusauth.com', { token: authToken })

Replacing Token

Generally you may need to replace PlusAuth REST API token because its lifetime could end. In this case updating options.token will be enough to change used token.

const initialToken = 'INITIAL_TOKEN'
const plusAuth = new PlusAuthRestClient('https://<YOUR_TENANT_ID>.plusauth.com', { token: initialToken })

plusAuth.apis.getAll().then( function (res){
// retrieved with initial token
console.log(res)
})

plusAuth.options.token = 'NEW_TOKEN'

plusAuth.apis.getAll().then(function (res){
// Retrieved with new token
console.log(res)
})

Custom HTTP Client

You may provide your own http client to the library when you need to have more control over your requests.

const axios = require('axios')
const plusAuth = new PlusAuthRestClient('https://<YOUR_TENANT_ID>.plusauth.com', {
    httpClient: function (url, options) {
        options.url = url
        options.data = options.body
        return axios(options)
    }
})

Docs

For API docs visit here

Examples

For more examples have a look at examples folder in this directory.