Salling Group API Authentication

This library allows you to easily set up an Axios instance that can query the Salling Group API.

Getting Started

This will check if 2017-12-24 is a holiday by querying the Holidays API.

const { createInstance } = require('@salling-group/auth');
const instance = createInstance({
  'applicationName': 'My Application v1.0.1',
  'auth': {
    'type': 'bearer',
    'token': 'my_token',
  },
});
 
instance.get('/v1/holidays/is-holiday', {
  'params': {
    'date': '2017-12-24',
  },
}).then((response) => console.log(response.data));

Instance

The authentication library exposes two authentication methods for setting up an Axios instance. This means that you can use this instance as you would use Axios, and it will handle authentication for you.

The available authentication methods are Bearer and JWT. You can get your credentials on the developer portal.

getInstance(options: object): Instance

This function gets a new Axios instance with access to the Salling Group API (given the provided credentials are correct and has access to the requested ressource). The provided options object must contain an auth object with the following specification:

Examples

Bearer

If you use a Bearer token, you can access the API like this:

const instance = createInstance({
  'applicationName': 'My Application v1.0.1',
  'auth': {
    'type': 'bearer',
    'token': 'my_token',
  },
});
instance.get('/v1/stores/').then(response => {
  console.log(response.data);
});

JWT

If you use a JWT, you can access the API like so:

const instance = createInstance({
  'applicationName': 'My Application v1.0.1',
  'auth': {
    'type': 'jwt',
    'issuer': 'my_issuer',
    'secret': 'my_secret',
  },
});
instance.get('/v1/stores/').then(response => {
  console.log(response.data);
});