@vonage/server-client

Vonage Auth SDK for Node.js

This is the Vonage Server Client SDK for Node.js used to wrap the authentication headers/signatures for use with Vonage APIs. To use it you will need a Vonage account. Sign up for free at vonage.com.

We recommend using this package as part of the overall @vonage/server-sdk package.

For full API documentation refer to developer.vonage.com.

• Installation
• Usage
  • Options
• Testing

Installation

With NPM

npm install @vonage/server-client

With Yarn

yarn add @vonage/server-client

Using the Vonage Server-Client SDK

To create a client, you will need to pass in a @vonage/auth object.

const { Auth } = require('@vonage/auth');
const { Client } = require('@vonage/server-client');

const vonageClient = new Client (new Auth({
        apiKey: API_KEY,
        apiSecret: API_SECRET,
        applicationId: APP_ID,
        privateKey: PRIVATE_KEY_PATH,
    }),
    options,
);

You will now be able to send requests using the client:

const response = await vonageClient.sendGetRequest('https://rest.nexmo.com/account/numbers')

Options

The constructor for the client takes in two parameters credentials and options. credentials is either an Auth or an object containing the settings from AuthInterface.

options allows adjusting api endpoints and the request timeout.

• restHost: string (optional) - Allows overwriting the default https://rest.nexmo.com.
• apiHost: string (optional) - Allows overwriting the default https://api.nexmo.com.
• videoHost: string (optional) - Allows overwriting the default https://video.api.vonage.com.
• responseType: 'json' | null (optional) - Allows setting the response data as text or json decoded.
• timeout: int (optional) - Set a custom timeout for requests to Vonage in milliseconds. Defaults to the standard for Node http requests, which is 120,000 ms.

Testing

Run:

npm run test