Skip to main content

Overview

This API allows you to receive real-time data streams of your Signals, via a MQTT connection.

The MQTT broker is available at mqtts://live.data.apps.nor.tech.

Authentication​

To authenticate yourself in the broker, use the following information:

  • username: <USERNAME>
  • password: <API BEARER TOKEN>

To request this information, contact us at support@nortech.ai.

Configuration​

Before subscribing to a MQTT data stream, it is necessary to create a Data Connection. A Data Connection defines which Signals and data format should be used in the data stream. To manage Data Connections you can use the HTTP API, using the same API Bearer Token.

The current available formats are: json or protobuf, with the following schema:

syntax = "proto3";

message DataPoint {
	uint64 timestamp = 1;
	oneof value {
		bool bool_value = 2;
		double double_value = 3;
		string string_value = 4;
	}
}

The data streams will be available in MQTT topics with the following format:

<dataFormat>/workspaces/<workspaceId>/assets/<assetId>/divisions/<divisionId>/units/<unitId>/signals/<signalId>

Where:

  • dataFormat: “json” or “protobuf”
  • workspaceId: ID of the Signal’s Workspace
  • assetId: ID of the Signal’s Asset
  • divisionId: ID of the Signal’s Division
  • unitId: ID of the Signal’s Unit
  • signalId: ID of the Signal
caution

At the moment, the single-level wildcard (+) is not supported.