Introduction

N3uron ’s REST API Server module is a component of the IIoT & DataOps platform that enables seamless access to the node, facilitating data retrieval and command transmission via REST calls. With this interface, users effortlessly can navigate Data Models programmatically. 

The API Server acts as an API gateway for industrial data residing in OT systems by offering a streamlined abstraction layer over diverse protocols—OPC UA, MQTT, Sparkplug, Modbus, DNP3, DLMS, IEC 102, IEC 104, etc.—eliminating the need for domain expertise in underlying systems. Any application or service with an HTTP client can securely request OT data in raw or modeled form directly from N3uron

The main features of N3uron’s REST API Server are:

• User authentication based on user/password or access token.
• High performance to support unlimited remote clients and connections.
• Secure HTTPS connections.
• Data encryption using self-signed or CA signed certificates.
• Compatible with Automated Certificate Management systems.
• Permits to read and write real-time values of tags.
• Permits to retrieve and acknowledge alarms.
• Permits to retrieve raw and aggregated historical data of several tags in the same request.
• Permits to retrieve and control the status of the system, modules, licenses, links and backups.
• Permits to change the configuration without having to access the WebUI.
• Complete control over the access and permissions of each user.

The REST server uses by default port 3003 for HTTP requests and port 3443 for HTTPS requests, both ports are configurable.

To create a REST request, a URL is built containing the IP address, service HTTP or HTTPS port, and all other information the server needs in order to complete the desired task. Data is returned in JSON format.