Cloud Services API ReferenceGeneral ServiceDevice Cloud to Cloud Integration ServiceDevice Cloud to Cloud IntegrationReport Device DPs

Report Device DPs

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

The partner cloud reports device data points (DPs). That is, the function properties of the specified device.

API address

POST: /v1.0/cloud/thing/devices/{device_id}/datapoint/report

Request parameter

Parameter name	Type	IN	Required	Description
device_id	String	uri	true	The ID of the specified Tuya-enabled device.

Description of body

Parameter name	Type	IN	Required	Description
data	Object	body	true	The reported content of the specified DP. One or more DP data can be passed in a `data` field. In the sample request: `101` and `119`: the ID of the specified product DP. `value`: the value of the specified DP. `time`: the time when the DP value changes.

Return parameter

Parameter name	Type	Description
result	FusionResult	The response result.

Description of result

Parameter name	Type	Description
result	Object	The returned result.
code	String	The response code. It is empty when the request succeeded.
msg	String	The message that is returned if the request fails. It is empty if the request is successful.
success	Boolean	Indicates whether the request is successful. Valid values: `true`: success. `false`: failure.
t	Long	The 13-digit timestamp of a response.

Request example

POST: /v1.0/cloud/thing/devices/6cf4171005d11e2ca7****/datapoint/report

{
  "data": {
    "101": {
      "value": "online",
      "time": 1682392142000
    },
    "119": {
      "value": 80,
      "time": 1682392142000
    }
  }
}

Return example

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

Error code

For more information, see error code.

Prev DocUnbind Device

Next DocRegister Sub-device