@redhat-cloud-services/integrations-client

Javascript client for Integrations API

If you want to use RedHatInsights/notifications-backend you shouldn't use get requests directly, but rather use this client to integrate with this service.

Install

NPM

npm install --save @redhat-cloud-services/integrations-client

Or Yarn

yarn add @redhat-cloud-services/integrations-client

Usage

This client is using typescript and axios. Types are distributed with this package, so no need to define or install them separately.

To correctly bootstrap this API you should use this config (no need to define it multiple times, just one config and reimport it anywhere you want to use it).

// api.js
import APIFactory from '@redhat-cloud-services/integrations-client/utils'; 
import createEndpoint from '@redhat-cloud-services/integrations-client/endpointResourceV1CreateEndpoint';
import enableEndpoint from '@redhat-cloud-services/integrations-client/endpointResourceV1EnableEndpoint';

// BASE_PATH should be set in your constants file
const integrationsApi = APIFactory(BASE_PATH, undefined, { createEndpoint, enableEndpoint });
export integrationsApi;

If you want to add some interceptors you can use axios build in interceptors

// api.js
import axios from 'axios';
import { IntegrationsApi } from '@redhat-cloud-services/integrations-client';
const instance = axios.create();

// Request interceptor
instance.interceptors.request.use((request) => {
    // some logic to do with request
});

// Response interceptor
instance.interceptors.response.use((response) => {
    // some logic to do with request
});

// Error interceptor
instance.interceptors.response.use(null, (error) => {
    // some logic to do with error
});

// BASE_PATH should be set in your constants file
const integrationsApi = APIFactory(BASE_PATH, instance, { createEndpoint, enableEndpoint });
export integrationsApi;

Building

Run nx build @redhat-cloud-services/integrations-client to build the library.

Running unit tests

Run nx test @redhat-cloud-services/integrations-client to execute the unit tests via Jest.

API documentation

• README