@team-monite/sdk-api NPM

Monite API client for JavaScript

@team-monite/sdk-api is a library for interacting with the Monite API from JavaScript and TypeScript code.

This library is used internally by Monite UI Widgets to make requests to the Monite API. It can also be used as a standalone API client.

Note: This library is part of a monorepo. See the main README for more information.

Requirements

Runtime:
- Node.js 16 or later.
- Supported browsers: five latest versions of Chrome, Firefox, Safari, Edge, and Opera.
At least 8 GB RAM on each development workstation.
A partner account registered with Monite. Follow the Get started with Monite API guide to set up your partner account, get API credentials, and generate an access token.

Installation

npm install @team-monite/sdk-api --save --force

yarn add @team-monite/sdk-api

Usage

Example to get a list of an entity's counterparts:

import { MoniteSDK } from '@team-monite/sdk-api';

const monite = new MoniteSDK({
  /** Or 'https://api.monite.com/v1' to use Production */
  apiUrl: 'https://api.sandbox.monite.com/v1',

  /** Entity whose data you want to access */
  entityId: 'ENTITY_ID',

  /** Entity whose data you want to access */
  fetchToken: async () => {
    const response = await fetch('https://api.sandbox.monite.com/v1/token', {
      method: 'POST',
      body: JSON.stringify({
        grand_type: 'entity_user',
        clientId: 'SECRET_CLIENT_ID',
        clientSecret: 'SECRET_CLIENT_SECRET',
        entity_user_id: 'SECRET_ENTITY_USER_ID'
      })
    });

    return response.json();
  },
});

monite.api.counterparts.getList()  // Returns Promise<Response>
  .then(res => {
    console.log(`Number of counterparts: ${res.data.length}`);
  });