Calc-5172509-sdk NPM

Getting Started with Merged Api

Introduction

Boost API example documentation.

Authentication

Install the Package

Run the following command from your project directory to install the package from npm:

npm install calc-5172509-sdk@1.0.0

For additional package details, see the Npm page for the calc-5172509-sdk@1.0.0 npm.

Initialize the API Client

Note: Documentation for the client can be found here.

The following parameters are configurable for the API Client:

Parameter	Type	Description
`environment`	Environment	The API environment. Default: `Environment.Production22`
`timeout`	`number`	Timeout for API calls.Default: `0`
`httpClientOptions`	`Partial<HttpClientOptions>`	Stable configurable http client options.
`unstableHttpClientOptions`	`any`	Unstable configurable http client options.
`oAuthClientId`	`string`	OAuth 2 Client ID
`oAuthClientSecret`	`string`	OAuth 2 Client Secret
`oAuthToken`	`OAuthToken`	Object for storing information about the OAuth token

HttpClientOptions

Parameter	Type	Description
`timeout`	`number`	Timeout in milliseconds.
`httpAgent`	`any`	Custom http agent to be used when performing http requests.
`httpsAgent`	`any`	Custom https agent to be used when performing http requests.
`retryConfig`	`Partial<RetryConfiguration>`	Configurations to retry requests.

RetryConfiguration

Parameter	Type	Description
`maxNumberOfRetries`	`number`	Maximum number of retries. Default: `0`
`retryOnTimeout`	`boolean`	Whether to retry on request timeout. Default: `true`
`retryInterval`	`number`	Interval before next retry. Used in calculation of wait time for next request in case of failure. Default: `1`
`maximumRetryWaitTime`	`number`	Overall wait time for the requests getting retried. Default: `0`
`backoffFactor`	`number`	Used in calculation of wait time for next request in case of failure. Default: `2`
`httpStatusCodesToRetry`	`number[]`	Http status codes to retry against. Default: `[408, 413, 429, 500, 502, 503, 504, 521, 522, 524]`
`httpMethodsToRetry`	`HttpMethod[]`	Http methods to retry against. Default: `['GET', 'PUT']`

The API client can be initialized as follows:

const client = new Client({
  timeout: 0,
  environment: Environment.Production22,
  oAuthClientId: 'OAuthClientId',
  oAuthClientSecret: 'OAuthClientSecret',
});

Environments

The SDK can be configured to use a different environment for making API calls. Available environments are:

Fields

Name	Description
production22	Default Production environment, This environment connect to the LIVE calculator API
development	development

Authorization

This API uses OAuth 2 Client Credentials Grant.

Client Credentials Grant

Your application must obtain user authorization before it can execute an endpoint call in case this SDK chooses to use OAuth 2.0 Client Credentials Grant. This authorization includes the following steps

The fetchToken method will exchange the OAuth client credentials for an access token. The access token is an object containing information for authorizing client requests and refreshing the token itself.

try {
  const token = await client.clientCredentialsAuthManager.fetchToken();
} catch(error) {
  // handle error
}

The client can now make authorized endpoint calls.

Storing an access token for reuse

It is recommended that you store the access token for reuse.

Store the token in session storage or local storage.

Creating a client from a stored token

To authorize a client from a stored access token, just set the access token in Configuration along with the other configuration parameters before creating the client:

const newClient = client.withConfiguration({oAuthToken: token});

List of APIs

Classes Documentation

@apimatic/axios-client-adapter @apimatic/core @apimatic/oauth-adapters @apimatic/schema

@everything-registry/sub-chunk-1285

1.0.0

9 months ago