智能小程序 Ray 开发——设备日志 API 接口汇总

getAnalyticsLogsPublishLog

该接口为云能力，需开通授权后使用，关于云能力可查看文档

获取时间段里的下发日志历史记录

请求参数

参数	数据类型	说明	是否必填
devId	string	设备 ID	是
dpIds	string	DP 点 ID，可以是多个 DP，用逗号隔开即可	是
offset	number	查询返回结果时从指定序列后的结果开始返回(offset 从 0 开始)	是
limit	number	单页的最大值，offset + limit 要小于等于 1000	是
startTime	string	设备上报的时间，查询起始时间，单位为毫秒。为空默认填充 7 天前时间戳	否
endTime	string	设备上报的时间，查询结束时间，单位为毫秒。为空默认填充当前时间戳	否
sortType	string	DESC 倒序 或 ASC 顺序，默认 DESC	否

返回参数

参数	数据类型	说明
dps	Dps
hasNext	boolean
total	number

Dps 说明

参数	数据类型	说明
dps	DpResult[]

DpResult 说明

参数	数据类型	说明
dpId	number	dpId
value	any	dp value
timeStamp	number	时间戳
timeStr	string	时间文本
nickName	string	昵称
userName	string	用户名

请求示例

// @ray-js/ray^1.4.11
import { getAnalyticsLogsPublishLog } from '@ray-js/ray';
 
getAnalyticsLogsPublishLog({
  devId: '6c272a8d82e3ed8300mizk',
  dpIds: '103,27',
  offset: 0,
  limit: 10,
})
  .then((response) => {
    console.log(response);
  })
  .catch();

返回示例

{
  "dpc": [],
  "dps": [
    {
      "dpId": 27,
      "nickName": "86-15583441913",
      "timeStamp": 1696842723,
      "timeStr": "2023-10-09 17:12:03",
      "userName": "86-15583441913",
      "value": "0000003e8006600000000"
    },
    {
      "dpId": 27,
      "nickName": "86-15583441913",
      "timeStamp": 1696842722,
      "timeStr": "2023-10-09 17:12:02",
      "userName": "86-15583441913",
      "value": "0000003e8006600000000"
    },
    {
      "dpId": 27,
      "nickName": "86-15583441913",
      "timeStamp": 1696842722,
      "timeStr": "2023-10-09 17:12:02",
      "userName": "86-15583441913",
      "value": "0000003e8006600000000"
    },
    {
      "dpId": 27,
      "nickName": "86-15583441913",
      "timeStamp": 1696842720,
      "timeStr": "2023-10-09 17:12:00",
      "userName": "86-15583441913",
      "value": "0000003e8006600000000"
    },
    {
      "dpId": 27,
      "nickName": "86-15583441913",
      "timeStamp": 1696842720,
      "timeStr": "2023-10-09 17:12:00",
      "userName": "86-15583441913",
      "value": "0000003e8006600000000"
    },
    {
      "dpId": 27,
      "nickName": "86-15583441913",
      "timeStamp": 1696842720,
      "timeStr": "2023-10-09 17:12:00",
      "userName": "86-15583441913",
      "value": "0000003e8006600000000"
    },
    {
      "dpId": 27,
      "nickName": "86-15583441913",
      "timeStamp": 1696842719,
      "timeStr": "2023-10-09 17:11:59",
      "userName": "86-15583441913",
      "value": "0000003e8006600000000"
    },
    {
      "dpId": 27,
      "nickName": "86-15583441913",
      "timeStamp": 1696842719,
      "timeStr": "2023-10-09 17:11:59",
      "userName": "86-15583441913",
      "value": "0000003e8006600000000"
    },
    {
      "dpId": 27,
      "nickName": "86-15583441913",
      "timeStamp": 1696842719,
      "timeStr": "2023-10-09 17:11:59",
      "userName": "86-15583441913",
      "value": "0000003e8006600000000"
    },
    {
      "dpId": 27,
      "nickName": "86-15583441913",
      "timeStamp": 1696842718,
      "timeStr": "2023-10-09 17:11:58",
      "userName": "86-15583441913",
      "value": "0000003e8006600000000"
    }
  ],
  "hasNext": true,
  "total": 97815
}

👉 立即免费领取开发资源，体验涂鸦 MiniApp 小程序开发。 

getAnalyticsLogsStatusLog

该接口为云能力，需开通授权后使用，关于云能力可查看文档

获取时间段里的上报日志历史记录

请求参数

参数	数据类型	说明	是否必填
devId	string	设备 ID	是
dpIds	string	DP 点 ID，可以是多个 DP，用逗号隔开即可	是
offset	number	查询返回结果时从指定序列后的结果开始返回(offset 从0开始)	是
limit	number	单页的最大值，offset + limit 要小于等于 1000	是
startTime	string	设备上报的时间，查询起始时间，单位为毫秒。为空默认填充7天前时间戳	否
endTime	string	设备上报的时间，查询结束时间，单位为毫秒。为空默认填充当前时间戳	否
sortType	string	DESC 倒序 或 ASC 顺序，默认 DESC	否

返回参数

参数	数据类型	说明
dps	Dps
hasNext	boolean
total	number

Dps 说明

参数	数据类型	说明
dps	DpResult[]

DpResult 说明

参数	数据类型	说明
dpId	number	dpId
value	any	dp value
timeStamp	number	时间戳
timeStr	string	时间文本

请求示例

// @ray-js/ray^1.4.11
import { getAnalyticsLogsStatusLog } from "@ray-js/ray";
 
getAnalyticsLogsStatusLog({
  devId: "tuya1319563f96bc263b",
  dpIds: 103,
  offset: 0,
  limit: 10
})
  .then((response) => {
    console.log(response);
  })
  .catch();

返回示例

{
  "dpc": [],
  "dps": [
    {
      "dpId": "1, 103",
      "timeStamp": 1696845110,
      "timeStr": "2023-10-09 17:51:50",
      "value": "180"
    },
    {
      "dpId": "1, 103",
      "timeStamp": 1696845111,
      "timeStr": "2023-10-09 17:51:51",
      "value": "180"
    },
    {
      "dpId": "1, 103",
      "timeStamp": 1696845112,
      "timeStr": "2023-10-09 17:51:52",
      "value": "180"
    }
  ],
  "hasNext": false,
  "total": 3
}

 👉 立即免费领取开发资源，体验涂鸦 MiniApp 小程序开发。