Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The API organises objects in a logical and hierarchical structure for straight-forward navigation.

Generally objects are organised as follows:

Drawio
baseUrlhttps://nexdata.atlassian.net/wiki
diagramNameapi_structure_basic
width571
zoom1
tbstylehidden
pageId69735581
lbox0
height61
revision3

In order to get to the data, you'll need to traverse the API structure starting with the Controller. Here's an example:


Controller

adfFirst, you'll want to see what Controllers are available on your Account.

This will list your Controllers and their details.

Choose a specific Controller and request it using it's ID.

Request all Controllers

Code Block
languagexml
themeMidnight
<!-- GET -->
https://nexcloud.io/v1.0/Controller

Request a specific Controller

Code Block
languagexml
themeMidnight
<!-- GET -->
https://nexcloud.io/v1.0/Controller/5



Device

adf

Now that you have a Controller chosen, you can list all Devices connected to it.

These could be LAN devices, like power meters, or other sources, like an internet weather feed, etc.

Choose a specific Device and request it using it's ID.

Request all Devices on a Controller

Code Block
languagexml
themeMidnight
<!-- GET -->
https://nexcloud.io/v1.0/Controller/5/Device

Request a specific Device

Code Block
languagexml
themeMidnight
<!-- GET -->
https://nexcloud.io/v1.0/Device/15



Data Point

adaUsing the Device ID, you can see what Data Points are connected. A Data Point is a discreet data channel, like a temperature sensor reading, or phase-A current on a power meter.

Again, you can get the details of a specific Data Point using it's ID.

Now that we have a specific DataPoint, we are ready to retrieve data. This is covered in the next section.

Request all DataPoints on a Device

Code Block
languagexml
themeMidnight
<!-- GET -->
https://nexcloud.io/v1.0/Device/15/DataPoint

Request a specific Data Point

Code Block
languagexml
themeMidnight
<!-- GET -->
https://nexcloud.io/v1.0/DataPoint/123



Filter by label (Content by label)
showLabelsfalse
max5
spacesNS
showSpacefalse
sortmodified
reversetrue
typepage
cqllabel in ("api","data-read") and type = "page" and space = "NS"
labelsapi data-read


Page Properties
hiddentrue


Related issues