Query DP logs

Last Updated on : 2022-03-03 06:49:15

Returns the logs of data points (DPs) reported by a device. The logs only in the last seven days are supported. Common API requests are made to get the logs.

API description

API operation name	API version	Description
tuya.m.smart.operate.all.log	1.0	Query DP logs

Service parameters

Name	Type	Description	Required
devId	String	The device ID.	Yes
dpIds	String	The DPs to be returned, separated with commas (,). Example: `@"1,2"`.	Yes
offset	Integer	The number of entries starting from which entries are returned.	Yes
limit	Integer	The maximum number of entries returned per page.	Yes
startTime	String	The time when DP status reporting starts, in milliseconds.	No
endTime	String	The time when DP status reporting ends, in milliseconds.	No
sortType	String	The method to sort data by time. Valid values: `ASC`: sorted in ascending order `DESC`: sorted in descending order Default value: `DESC`.	No

Sample request

{
  "devId" : "05200020b4e62d16ce8b",
  "dpIds" : "1,2",
  "offset" : 0,
  "limit" : 10,
  "startTime" : "1542800401000",
  "endTime" : "1542886801000",
  "sortType" : "DESC"
}

Sample response

{
  "result" : {
    "total" : 11055,
    "dps" : [ {
      "timeStamp" : 1542829972,
      "dpId" : 5,
      "timeStr" : "2018-11-21 20:52:52",
      "value" : "311"
    }, {
      "timeStamp" : 1542829970,
      "dpId" : 5,
      "timeStr" : "2018-11-21 20:52:50",
      "value" : "323"
    }, {
      "timeStamp" : 1542829966,
      "dpId" : 5,
      "timeStr" : "2018-11-21 20:52:46",
      "value" : "230"
    }, {
      "timeStamp" : 1542829964,
      "dpId" : 5,
      "timeStr" : "2018-11-21 20:52:44",
      "value" : "231"
    }, {
      "timeStamp" : 1542829960,
      "dpId" : 5,
      "timeStr" : "2018-11-21 20:52:40",
      "value" : "307"
    }, {
      "timeStamp" : 1542829958,
      "dpId" : 5,
      "timeStr" : "2018-11-21 20:52:38",
      "value" : "320"
    }, {
      "timeStamp" : 1542829954,
      "dpId" : 5,
      "timeStr" : "2018-11-21 20:52:34",
      "value" : "229"
    }, {
      "timeStamp" : 1542829950,
      "dpId" : 5,
      "timeStr" : "2018-11-21 20:52:30",
      "value" : "325"
    }, {
      "timeStamp" : 1542829948,
      "dpId" : 5,
      "timeStr" : "2018-11-21 20:52:28",
      "value" : "292"
    }, {
      "timeStamp" : 1542829942,
      "dpId" : 5,
      "timeStr" : "2018-11-21 20:52:22",
      "value" : "231"
    } ],
    "hasNext" : true
  },
  "t" : 1542959314632,
  "success" : true,
  "status" : "ok"
}

Example

ObjC:

- (void)getOperationLogList {

  [[TuyaSmartRequest new] requestWithApiName:@"tuya.m.smart.operate.all.log" postData:@{@"devId":@"", @"dpIds":@"1", @"offset":@(0), @"limit":@(10)} version:@"1.0" success:^(id result) {

  } failure:^(NSError *error) {

  }];

}

Swift:

func getOperationLogList() {

    TuyaSmartRequest().init(apiName: "tuya.m.smart.operate.all.log", postData: [:], version: "1.0", success: { result in

    }, failure: { error in

    })
}