Novant

Documentation

Points

Retrieves the point list for a source.

POST /v1/points
curl https://api.novant.io/v1/points \
  -X POST \
  -u ak_sample_123: \
  -d source_id=s.1 \
  --compressed

Parameters

source_id Required

Parent source ID for point list. One of source_id or asset_id is required. If both are specified, source_id takes precedence.

asset_id Required

Parent asset ID for point list. One of source_id or asset_id is required. If both are specified, source_id takes precedence.

point_ids

An allowlist to filter points. Points must exist under source_id. Ids are formatted as a comma-separated list, i.e.: "s.1.1,s.1.2,s.1.5".

Returns

Returns point listing for the given source.

{
  "source_id": "s.1",
  "source_name": "ECB-600-1",
  "source_bound": true,
  "points": [
    {
      "id": "s.1.1",
      "name": "Discharge Air Temperature",
      "type": "discharge_air_temp_sensor",
      "addr": "ai.1",
      "kind": "num",
      "unit": "°F",
      "writable": false,
      "ontology": {
        "haystack": "point,air,temp,sensor,discharge"
      }
    },
    {
      "id": "s.1.2",
      "name": "Discharge Air Pressure",
      "type": "discharge_air_pressure_sensor",
      "addr": "av.2",
      "kind": "num",
      "unit": "inH₂O",
      "writable": true,
      "ontology": {
        "haystack": "point,air,pressure,sensor,discharge"
      }
    },
    {
      "id": "s.1.3",
      "name": "Cooling",
      "type": "generic"
      "addr": "av.3",
      "kind": "num",
      "unit": "%",
      "writable": true,
      "ontology": {
        "haystack": "point"
      }
    },
    ...
  ]
}