Report Device Property

Last Updated on : 2023-06-20 12:39:04

The device reports its property status information.

API address

POST: /v1.0/iot-03/3rdcloud/devices/{device_id}/property/report

Request parameter

Parameter nameTypeINRequiredDescription
device_idStringuritrueThe ID of the specified Tuya-enabled device.

Description of body

Parameter nameTypeINRequiredDescription
msg_idStringbodytrueThe unique identifier of the specified request, with no more than 32 characters.
dataObjectbodytrueThe reported content of the specified property.

Return parameter

Parameter nameTypeDescription
resultBooleanThe response result.
codeStringThe response code. It is empty when the request succeeded.
msgStringThe message that is returned if the request fails. It is empty if the request is successful.
successBooleanIndicates whether the request is successful. Valid values:
  • true: success.
  • false: failure.
tLongThe 13-digit timestamp of a response.

Request example

POST: /v1.0/iot-03/3rdcloud/devices/6cf4171005d11e2ca7****/property/report
{
  "msg_id": "ed23rty159292****",
  "data": {
    "resolution_ratio": {
      "value": 1080,
      "time": 1592920221212
    }
  }
}

Return example

{
    "result": true,
    "t": 1561456817168,
    "success": true
}

Error code

For more information, see error code.