Send Group Properties

Last Updated on : 2024-09-10 01:49:17

Send group properties based on the group ID. That is to say, send control commands to the devices in the specified group.

API address

POST: /v2.0/cloud/thing/group/properties

Request parameter

Description of body

Parameter nameTypeINRequiredDescription
group_idLongbodytrueThe ID of the specified group.
propertiesStringbodytrueThe property sent to the specified group.

Return parameter

Parameter nameTypeDescription
resultBooleanThe list of returned data.
successBooleanIndicates whether the operation is successful. Valid values:
  • true: The operation succeeded.
  • false: The operation failed.
tLongThe timestamp.
tidStringThe link ID.

Request example

POST: /v2.0/cloud/thing/group/properties
{
  "group_id": 89218****,
  "properties": "{    \"switch1\":true}"
}

Return example

{
    "tid": "77a9807fb74411edb9d75a827c79edfd",
    "result": true,
    "t": 1677574021435,
    "success": true
}

Error code

For more information, see error code.

Limits on API Request Frequency

For more information, see Limits on API Request Frequency.