SearchUnify SDK

Overview

The SearchUnify SDK enables developers to easily work with the SearchUnify platform and build scalable solutions with search, analytics, crawlers and more. You can get started in minutes using NPM. The SearchUnify SDK simplifies use of SearchUnify Services by providing a set of libraries that are consistent and familiar for the developers. It provides support for API lifecycle consideration such as credential management, retries, data marshaling, and serialization. The SearchUnify SDKs also support higher level abstractions for simplified development.

Key Features

• HTTP/2 Support and pluggable HTTP layer, new programming interfaces seamlessly take advantage of HTTP/2 features and provide new ways to build applications.
• Nonblocking I/O, the SearchUnify SDK for Javascript utilizes a new, nonblocking SDK architecture to support true nonblocking I/O. It features truly non blocking asynchronous clients that implement high concurrency across a few threads.

Getting Started

Sign up for SearchUnify, before you begin, you need a SearchUnify account. Please see the oAuth section of the developer guide for information about how to retrieve your SearchUnify credentials.

Installation

SDK requires Node.js to run. Install the dependencies and devDependencies and start the server.

Authentication

The SDK supports multiple authentication methods to securely connect to your SearchUnify instance. Depending on your setup, you can initialize the SDK using OAuth 2.0, API Key, or Client Credentials authentication.

1. OAuth 2.0 (Password Grant) Initialize the SDK using your OAuth 2.0 credentials. An access token will be generated internally and used automatically by the SDK to serve requests to your SearchUnify instance.

Example

const { SearchUnifyRestClient, AUTH_TYPES } = require('su-sdk');

const suRestClient = new SearchUnifyRestClient({
  instance: 'https://yourInstance.searchunify.com',
  timeout: 60000,
  authType: AUTH_TYPES.PASSWORD,
  oauth2: {
    username: 'changeme',
    password: 'changeme',
    clientId: 'changeme',
    clientSecret: 'changeme'
  }
})

The access token expires after 4 hours, SDK recreates access token once the token expires using refresh token.

2. API Key Authentication Generate the API key from the SearchUnify admin panel.

Example

const { SearchUnifyRestClient, AUTH_TYPES } = require('su-sdk');

const suRestClient = new SearchUnifyRestClient({
  instance: 'https://yourInstance.searchunify.com',
  timeout: 60000,
  apiKey: 'changeme',
  authType: AUTH_TYPES.API_KEY
});

The API key will expire based on the expiry date you choose while generating the api key.

3. Client Credentials (OAuth 2.0) For server-to-server communication, use the OAuth 2.0 Client Credentials flow. The SDK will generate an access token internally and use it for API requests.

Example

const { SearchUnifyRestClient, AUTH_TYPES } = require('su-sdk');

const client = new SearchUnifyRestClient({
  instance: 'https://your-instance.searchunify.com',
  timeout: 60000,
  authType: AUTH_TYPES.CLIENT_CREDENTIALS,
  oauth2: {
    clientId: 'your-client-id',
    clientSecret: 'your-client-secret'
  }
});

The access token expires after 4 hours, SDK recreates access token once the token expires using refresh token.

Execution

Initiate SearchUnify javascript SDK on Server. Using the SDK, you can use SearchUnify functional interface to retrieve or save data. To start using, initialize the SDK with your URL and API key.

const { SearchUnifyRestClient, AUTH_TYPES } = require('su-sdk');

const suRestClient = new SearchUnifyRestClient({
  instance: 'https://yourInstance.searchunify.com',
  timeout: 60000,
  oauth2: {
    username: 'changeme',
    password: 'changeme',
    clientId: 'changeme',
    clientSecret: 'changeme'
  }
})

Sample API call

const tileData = async() => {
  try {
      const Analytics = suRestClient.Analytics();
      const data = await Analytics.getTilesData({
        startDate: '2022-12-09',
        endDate: '2022-12-10',
        searchClientId: 'searchClient UID'
      });
      console.log("data", data);
      } catch (error) {
      console.log("error", error);
  }
};

tileData();

Documentation

Please refer to the SearchUnify developer guide to use the SDK. https://docs.searchunify.com/Content/Developer-Guides/SDKs.htm The documentation is in review and might contain bugs🐞, we will update the link on https://docs.searchunify.com once its's final.

License

MIT

© Powered by SearchUnify!