points

get list of points timeseries

get list of points timeseries, points could be sensors, actuators, parameters, commands, setpoints or alarms

get/points/timeseries

Request

  • Base URL
    https://api.relynk.io/v2.0.0
  • Auth
    • HTTP bearer
    • or API key in header Authorization

Query parameters

customerIdstring uuid required

customer id context, id can be fetched from /customers endpoint

fromstring date-time

from date time, when provided together with parameter "to", the timespan must not exceed 6 months

tostring date-time

to date time, when provided together with parameter "from", the timespan must not exceed 6 months

limitinteger

limit the number returned

offsetinteger

offset the returned list

order'asc' | 'desc'

order the returned list

sort'timestamp'

sort the returned list

namestring

filter by name

name__containsstring

filter by name contains

idstring uuid

filter by id

fromIntegrationIdstring

filter by from integration id

fromIntegrationNamestring

filter by from integration name

subtypestring

filter by subtype using brickschema/real estate core standard full uri.

hasUnitstring

filter by unit

isPointOfAssetIdstring uuid

filter by is point of asset id

isPointOfAssetNamestring

filter by is point of asset name

isPointOfAssetName__containsstring

filter by is point of asset name contains

isPointOfSpaceIdstring uuid

filter by is point of space id

isPointOfSpaceNamestring

filter by is point of space name

isPointOfSpaceName__containsstring

filter by is point of space name contains

includeOptionalFieldsstring[]

include point value fields that are not returned by defafault. these match the returned fields object keys that they will enable.

Response

get point values

customerIdstring uuid required

customer id that point belongs to

idstring uuid required

point id

namestring nullable
hasUnitstring nullable

(not returned by default) using qudt/brickschema/real estate core standard full uri.

subtypestring nullable

using brickschema/real estate core standard full uri.

timestampstring date-time required
valuenumber required

point value

Example response

[
  {
    "customerId": "123e4567-e89b-12d3-a456-426614174000",
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "timestamp": "2021-01-01T00:00:00Z",
    "name": "501 - temp sensor RT601",
    "value": 20,
    "hasUnit": "http://qudt.org/vocab/unit/DEG_C",
    "subtype": "https://brickschema.org/schema/Brick#Temperature_Sensor"
  }
]

Changes

No recorded changes to this operation across all 1 revision of this API.