points

get list of points latest values

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

get/points/latest-values

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

limitinteger

limit the number returned

offsetinteger

offset the returned list

order'asc' | 'desc'

order the returned list

sort'id' | 'name' | 'value' | '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, using qudt/brickschema/real estate core standard full uri.

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 latest values

customerIdstring uuid required

customer id that point belongs to

idstring uuid required

point id

namestring nullable

point name

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.

valuenumber required

point value

timestampstring date-time required

point timestamp

Example response

[
  {
    "customerId": "123e4567-e89b-12d3-a456-426614174000",
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "501 - temp sensor RT601",
    "timestamp": "2021-01-01T00:00:00Z",
    "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.