company-api

An API for aggregating NUM Contacts Module and Images Module Records into a single object using the NUM Protocol.

Installation For Local Testing

- git clone git@github.com:NUMtechnology/company-api.git
- cd company-api
- npm install
- Open test/index.html in your browser.

Installation For Use In An Application

- npm install -s company-api

Simple Application Usage in JavaScript

``JavaScript
const companyApi = require('company-api');

// Create an API instance
const api = companyApi.createCompanyApi();

// Use it to look up a domain
api.lookupDomain('numexample.com').then((result) => {
console.log(JSON.stringify(result));
}, (err)=>{
console.error('ERROR: ', JSON.stringify(err));
});
`


Simple Application Usage in TypeScript

`typescript
import { createCompanyApi } from 'company-api';

// Create an API instance
const api = createCompanyApi();

// Use it to look up a domain
api.lookupDomain('numexample.com').then((result) => {
console.log(JSON.stringify(result));
}, (err)=>{
console.error('ERROR: ', JSON.stringify(err));
});
`

Controlling the Recursion Levels

`typescript
import { createCompanyApi, CompanyApiOptions } from 'company-api';

// Create an API instance
const api = createCompanyApi();

const versionMap = new Map();
// Module 1 (Contacts) is currently at version 2, the others will default to version 1.
// An empty map can be supplied which sets the default version for each NUM module ('2' for Contacts, '1' for everything else).
versionMap.set(1,'2');
versionMap.set(3,'1.5'); // E.g. use v1.5 of the Images module (if such a version exists)

const options = new CompanyApiOptions(
2, // The number of levels for Contacts records. 0 returns no contacts data.
1, // The number of levels for Images records. 0 returns no images data.
versionMap
);

// Use it to look up a domain
api.lookupDomain('numexample.com', options).then((result) => {
console.log(JSON.stringify(result));
}, (err)=>{
console.error('ERROR: ', JSON.stringify(err));
});
`

Supplying an Existing NUMClient Object

If you already have a NUMClient object you can re-use it.
`typescript
import { createClient } from 'num-client';
import { createCompanyApi } from 'company-api';

// (from another part of your application)
const existingClient = createClient();

// Inject the existing client when creating the API instance
const api = createCompanyApi(existingClient);

// Use it to look up a domain
api.lookupDomain('numexample.com').then((result) => {
console.log(JSON.stringify(result));
}, (err)=>{
console.error('ERROR: ', JSON.stringify(err));
});
``