Vonage Verify SDK for Node.js

This is the Vonage Verify (for version 1) SDK for Node.js for use with Vonage APIs. To use it you will need a Vonage account. Sign up for free at vonage.com.

Note: This package is only compatible with verify V1.

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

If you are updating from V2 to V3 of the SDK, please check the migration guide found here

• Installation
• Usage
• Promises
• Testing

Installation

We recommend using this SDK as part of the overall @vonage/server-sdk package. Please see the main package for installation.

You can also use this SDK standalone if you only need access to just the Verify API.

With NPM

npm install @vonage/verify

With Yarn

yarn add @vonage/verify

Usage

As part of the Vonage Server SDK

If you are using this SDK as part of the Vonage Server SDK, you can access it as the verify property off of the client that you instantiate.

const { Vonage } = require('@vonage/server-sdk')

const credentials = {
  apiKey: API_KEY,
  apiSecret: API_SECRET,
}
const options = {}
const vonage = new Vonage(credentials, options)

vonage.verify
  .check(VERIFY_REQUEST_ID, CODE)
  .then((resp) => console.log(resp))
  .catch((err) => console.error(err))

Standalone

The SDK can be used standalone from the main Vonage Server SDK for Node.js if you only need to use the Verify API. All you need to do is require('@vonage/verify'), and use the returned object to create your own client.

const { Auth } = require('@vonage/auth')
const { Verify } = require('@vonage/verify')

const credentials = new Auth({
  apiKey: API_KEY,
  apiSecret: API_SECRET,
})
const options = {}
const verifyClient = new Verify(credentials, options)

Where credentials is any option from @vonage/auth, and options is any option from @vonage/server-client

Promises

Most methods that interact with the Vonage API uses Promises. You can either resolve these yourself, or use await to wait for a response.

const resp = await vonage.vrify.check(VERIFY_REQUEST_ID, CODE)

vonage.verify
  .check(VERIFY_REQUEST_ID, CODE)
  .then((resp) => console.log(resp))
  .catch((err) => console.error(err))

Testing

Run:

npm run test