Emil Public Api SDK for Nodejs

This TypeScript/JavaScript client utilizes axios. The generated Node module can be used with Nodejs based applications.

Language level

• ES5 - you must have a Promises/A+ library installed
• ES6

Module system

• CommonJS
• ES6 module system

Although this package can be used in both TypeScript and JavaScript, it is intended to be used with TypeScript. The definition should be automatically resolved via package.json. (Reference). For more information, you can go to Emil Api documentation.

Consuming

Navigate to the folder of your consuming project and run one of the following commands:

npm install @emilgroup/[email protected] --save

or

yarn add @emilgroup/[email protected]

And then you can import PublicApi.

import { PublicApi } from '@emilgroup/public-api-sdk-node'

const publicApi = new PublicApi();

Credentials

To use authentication protected endpoints, you have to first authorize. To do so, the easiest way is to provide a configuration file under ~/.emil/credentials with the following content:

[email protected]
emil_password=XXXXXXXXXXXXXX

It is also possible to provide environment variables instead:

export [email protected]
export EMIL_PASSWORD=XXXXXXXXXXXXXX

Base path

To select the basic path for using the API, we can use two approaches. The first is to use one of the predefined environments, and the second is to specify the domain as a string.

import { PublicApi, Environment } from '@emilgroup/public-api-sdk-node'

const publicApi = new PublicApi();

// Allows you to simply choose environment. It will usually be Environment.Production.
publicApi.selectEnvironment(Environment.Production);

// For advanced users, use the custom baseUrl of the website you need to connect to.
publicApi.selectBasePath('https://my-custom-domain.com');

Example

Here is a basic functionning example:

async function listDocuments(): Promise<Void> {
    try {
        const publicApi = new PublicApi();

        await publicApi.initialize(); // should be called only once per Api.

        const { data: { items } } = await publicApi.listDocuments();

        console.log(items);
    } catch(error) {
      // process error
  }
}