Skip to content

Industrial IoT SDK for Node.js

Introduction

The Industrial IoT SDK for Node.js enables developers to work with Insights Hub easily. It is divided into core module and several service modules, which allows developers to include only those parts of the SDK required for their use case.

The core module provides features like client configuration, authentication, token handling, logging, and a common API client implementation to access the RESTful Industrial IoT APIs. All service modules have a dependency on the core module.

The Industrial IoT SDK for Node.js provides client implementations for the following APIs:

NameAPI Version
SDK Core1.0.0
Asset Management3.9.4
IoT Time Series3.2.3
IoT TS Aggregates4.2.3
IoT File3.2.3
Event Analytics3.1.3

Refer to the Getting Started for installation and configuration of an API client.

Get the SDK

The Industrial IoT SDK for Node.js is available for download on the Siemens Industry Online Support (SIOS) Portal. The SDK core and service specific modules are in TGZ format and bundled into a ZIP file.

Download for region China 1

For region China 1, download the zip file with Region China special label version from the Siemens Industry Online Support (SIOS) Portal.

Features

Industrial IoT SDK Core

The core module of the Industrial IoT SDK for Node.js provides features like client configuration, authentication, token handling, logging, and a common API client to access all RESTful Industrial IoT APIs. All the service modules have a dependency on the core module.

Client Configuration

The ClientConfig model provides an interface to configure proxy settings and connection time-outs.

Token Handling Mechanism

The Industrial IoT SDK for Node.js provides an easy mechanism for configuring user authorization tokens or service credentials for fetching technical tokens. It handles technical token fetching, token caching, validation and re-fetching.

Refer to Token Handling for more information.

Logging

Logging is configured using the debug module. It can be enabled or disabled.

Refer to Logging for more information.

Error Handling

The Industrial IoT SDK for Node.js provides simple and readable exceptions in JSON format. Exceptions contain the error code and description of the error for easy parsing and processing.