Send Property

Last Updated on : 2024-06-29 01:03:33download

Based on the device ID, immediately send a property setting command to the specified device. When the device is offline, the sending process will fail.

API address

POST: /v2.0/cloud/thing/{device_id}/shadow/properties/issue

Request parameter

Parameter nameTypeINRequiredDescription
device_idStringuritrueThe device ID.

Description of body

Parameter nameTypeINRequiredDescription
propertiesStringbodytrueThe property to be supported by the device. In JSON parsable data, the key is the property code, and the value is the property value that is sent.

Return parameter

Parameter nameTypeDescription
resultJSONThe returned result. Currently, no result is sent.
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/372817193*****/shadow/properties/issue
{
  "properties": "{\"switch_1\":true}"
}

Return example

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

Error code

For more information, see error code.