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:
Name | API Version |
---|---|
SDK Core | 1.0.0 |
Asset Management | 3.9.4 |
IoT Time Series | 3.2.3 |
IoT TS Aggregates | 4.2.3 |
IoT File | 3.2.3 |
Event Analytics | 3.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.