Sensors
How to send sensors data to twinzo REST API
Configuration
Endpoint used to gather discrete data inputs like temperature, humidity, OEE, KPIs, produced pcs, parking slots and many more.
To learn how to connect sensor values with 3D spaces, please visit this course page:
Areas: Areas | twinzo - Digital Twin
Sensors: Sensors | twinzo - Digital Twin
Endpoint used to gather discrete data inputs like temperature, humidity, OEE, KPIs, produced pcs, parking slots and many more.
To learn how to connect sensor values with 3D spaces, please visit this course page:
Areas: Areas | twinzo - Digital Twin
Sensors: Sensors | twinzo - Digital Twin
Swagger sensors section
There is a description of the API for sensor data.
There is a description of the API for sensor data.
a. /sensors/sensor-data
i. Used when the sensor sends data on its own
ii. The sensor uses login/password to obtain an oAuth token, which is then signed
b. /sensors/batch
i. Used when the API, middleware, edge computer sends data for multiple sensors
ii. An array of sensors is sent, each identified using Login
iii. A static API key is used for signing.
Example
Message for sensor data
Data Properties
- Byte, SByte
- Int32, UInt32, Int16, UInt16, Int64, UInt64
- Single, Double, Decimal
- Char, String
- Boolean
- DateTime
Note:
Every value is passed to the JSON object as a string in parenthesis. Twinzo API is parsing value according to the data type specified. Default datatype is String.
For example, the Boolean and numeric values will look like this:
- "Value": "true"
- "Value": "123"
Message for sensor data
Data Properties
This is a JSON object that contains an array of objects. Each object has six properties:
- Login: Sensor login field(used as a unique identifier in the batch data POST).
- Timestamp: A Unix timestamp in milliseconds that represents the time when the data was collected.
- Timestamp: A Unix timestamp in milliseconds that represents the time when the data was collected.
- Quantity: A string that represents the quantity of data collected.
- Value: A string that represents the value of the data collected.
- Unit: A string that represents the unit of measurement for the data collected.
- DataType: A string that represents the type of data collected.
- ValueOK: A boolean value that indicates whether or not the value of the data collected is valid. If not valid, the sensor will be highlighted in the 3D application.
Supported data types- Byte, SByte
- Int32, UInt32, Int16, UInt16, Int64, UInt64
- Single, Double, Decimal
- Char, String
- Boolean
- DateTime
Note:
Every value is passed to the JSON object as a string in parenthesis. Twinzo API is parsing value according to the data type specified. Default datatype is String.
For example, the Boolean and numeric values will look like this:
- "Value": "true"
- "Value": "123"
| Views | |
|---|---|
| 1 | Total Views |
| 1 | Members Views |
| 0 | Public Views |
| Actions | |
|---|---|
| 0 | Likes |
| 0 | Dislikes |
| 0 | Comments |