Sidebar
Datastream
Datastreams represent incoming or outgoing data points for a device in the digital customer platform, including their topic, type, and current value.Attributes
These are all attributes that can be read and updated through the API
| Name | Description | Permissions |
|---|---|---|
| name | The display name of the datastream. | READ AND UPDATE |
| type | The category or kind of datastream. | READ AND UPDATE |
| topic | The subject area or data topic associated with the datastream. | READ AND UPDATE |
| id_slug | A URL-friendly unique identifier for the datastream. | READ AND UPDATE |
Get historian data
GEThttps://f4d4c187c4.autonoma.cloud/connect/v1/data/[ID]Load historian data by ID. If no parameters are set, the last value is returned. The fields must be sent as x-www-form-urlencoded parameter.
| Parameter | Description | Example |
|---|---|---|
| from | Optional The timestamp when the data shall be returned from | 2025-01-20T00:00:00.000Z |
| to | Optional The timestamp when the data shall be returned to | 2025-01-21T00:00:00.000Z |
| groupby | Optional This parameter can be used define the aggregation of the data. If not set the aggregation will be set automatically. Valid values are: 1m (minutes), 1h (hours), 1d (days) | 20m |
Get Datastream by ID
GEThttps://f4d4c187c4.autonoma.cloud/connect/v1/resources/datastream/[ID]Returns a specific Datastream by ID.
Get Relations
It is possible to get related objects from Datastreams.
GEThttps://f4d4c187c4.autonoma.cloud/connect/v1/resources/datastream/[ID]/[RELATION]This table shows all available resources that can be queried
| Relation | Objecttype | Relationtype | |
|---|---|---|---|
| asset | Asset | 1:1 | Show details |
Load data
Returns data using the provided time range, grouping, and aggregation settings.
GEThttps://f4d4c187c4.autonoma.cloud/connect/v1/resources/datastream/[ID]/call/dataThis table shows all available parameters
| Name | Description | Required | |
|---|---|---|---|
| from | Start of the time range. | ||
| to | End of the time range. | ||
| groupby | Grouping interval. | ||
| aggregate | Aggregation method. | ||
| params | Additional parameters. | ||
| timezone | IANA timezone. Timestamps in the answer are in this zone, day and week buckets start at its midnight, and a 'from' or 'to' without an offset is read in it. Default: Europe/Vienna. | ||
| timeformat | 'wallclock' (default) answers '2026-03-10 09:00:00'. 'iso' answers '2026-03-10T09:00:00+09:00', which stays unique when the clock is set back. |
Write data
Inserts datapoints into the datastream.
POSThttps://f4d4c187c4.autonoma.cloud/connect/v1/resources/datastream/[ID]/call/writeThis table shows all available parameters
| Name | Description | Required | |
|---|---|---|---|
| payload | JSON array of datapoints, e.g. [{"ts":1703785121,"val":23.2}]. "ts" is a unix timestamp in seconds or milliseconds, so it needs no timezone. "val" is a number, or a string for a text datastream. | required |
Update Datastream
POSThttps://f4d4c187c4.autonoma.cloud/connect/v1/resources/datastream/[ID]Update fields of Datastream by ID. The fields must be sent as x-www-form-urlencoded parameter.
Create Datastream
PUThttps://f4d4c187c4.autonoma.cloud/connect/v1/resources/datastreamCreate a new Datastream.
Delete Datastream
DELETEhttps://f4d4c187c4.autonoma.cloud/connect/v1/resources/datastream/[ID]Delete the resource Datastream by ID.
This action can not be reverted!