How to get from REST API list of available capabilities of operations

[vitalii.galchenko]

Hello,
I’m using a free trial with the latest version of cumulocity. I’m working on integrating the external system with cumulocity through REST API. I want to output all available operations with capabilities (seems that sometimes it is named fragments). For example, when I connect my smartphone through Cumulocity Sensor App I can retrieve a list of available operations: c8y_Message and c8y_Relay . In the documentation, we find that c8y_Relay operation has two states: OPEN, CLOSED . But can anyone suggest whether these states can be obtained through the REST API?

Thank you!

[Harald_Meyer]

Hi,

do you mean the current state for a specific device or all the possible states?

The current state of the device is stored in the c8y_Relay fragment of the managed object (I guess you know that already). The possible states are not available via the REST API.

Best regards

[vitalii.galchenko]

Hi,
yes, I need all available states. If we could get them via REST, we could build commands that would cover all possible cases. For example, we could create a commands to turn the phone on and off without adding any special conditions that have to be added manually.

Thanks!
Best regards, Vitalii

[Harald_Meyer]

Unfortunately that is not available via the REST API as it actually does not enforce that you use just the documented state.

[Christian_Herzog]

c8y_Relay can be also an array e.g.:

{
   "c8y_RelayArray": [
      "OPEN",
      "CLOSED",
      "OPEN"
   ]
}

Also here I saw only “OPEN” or “CLOSED” as possible entries.