The Vantiq NodeJS SDK is JavaScript library that provides an API into a Vantiq system for NodeJS applications. The SDK connects to a Vantiq system using the Vantiq REST API.
The SDK is available as an NPM module. To install, use:
% npm install vantiq-sdk
You will need valid credentials on a Vantiq server in the form of a username and password. If you have a private Vantiq server, contact your administrator for credentials. If you wish to use the Vantiq public cloud, contact [email protected].
The first step is to create an instance of the Vantiq SDK providing the URL of the Vantiq server to connect:
var Vantiq = require('vantiq-sdk');
var vantiq = new Vantiq({
server: 'https://dev.vantiq.com',
apiVersion: 1
});
where <server> is the full URL for the Vantiq server to connect to, such as https://dev.vantiq.com/ and apiVersion is the version of the API to use. If not specified, this defaults to the latest version, currently 1. At this point, the Vantiq instance has not yet connected to the server. To establish a connection to the server, use the authenticate method:
var promise = vantiq.authenticate(<username>, <password>);
promise.then((result) => {
console.log('Connected!');
});
The <username> and password are the same credentials used to log into the system. Note the username and password are not stored either in-memory or persistently after this authentication call. After successfully authenticating with the system, the Vantiq instance stores in-memory an access token that subsequent API calls will use.
Now, you are able to perform any SDK calls to the Vantiq server. For example, the following prints out the list of types that have been defined:
var promise = vantiq.select('system.types');
promise.then((resultSet) => {
resultSet.each(entry => console.log(entry));
});
For the full documentation on the SDK, see the SDK API Reference.
For examples of working applications that use the SDK, see the examples folder.
Copyright © 2022 Vantiq, Inc. Code released under the MIT license.