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

getDpLogDays

获取设备每日上报的数据统计。

请求参数

参数	数据类型	说明	是否必选
devId	String	设备 ID	是
dpId	String	DP 点的 ID	是
type	String	统计的类型，sum、minux 或 max。请提交工单确保 API 统计类型和后台管理系统统计类型一致。	否
startDay	String	开始日期	是
endDay	String	结束日期	是

返回结果

参数	数据类型	说明
total	string	总条数
values	string	每天对应的值
days	string	天的集合

请求示例

import { getDpLogDays } from '@ray-js/ray';
 
getDpLogDays({
  devId: 'vdevo161733425146241',
  dpId: '26',
  type: 'sum',
  startDay: '20210501',
  endDay: '20210530',
})
  .then((response) => {
    console.log(response);
  })
  .catch();

返回示例

{
    "total": "0.00",
    "values": [
        "0.00",
        "0.00"
    ],
    "days": [
        "05-18",
        "05-19"
    ]
}

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

getDpReportLog

获取 DP 点上报日志。

请求参数

参数	数据类型	说明	是否必填
devId	String	设备 ID	是
dpIds	String	DP 点 ID，可以是多个 DP，用逗号隔开即可	是
offset	Integer	查询返回结果时从指定序列后的结果开始返回	是
limit	Integer	单页的最大值，offset + limit 要小于等于 4000	是
sortType	String	DESC 倒序 或者 ASC 顺序	否

返回结果

参数	数据类型	说明
total	number	总条数
dps	Dp[]	见 Dp
hasNext	boolean	是否有下一页

请求示例

import { getDpReportLog } from '@ray-js/ray';
 
getDpReportLog({
  devId: `${YOUR_DEVICE_ID}`,
  dpIds: '20,30', // 多个DP
  offset: 0,
  limit: 3,
  sortType: 'ASC',
})
  .then((response) => {
    console.log(response);
  })
  .catch();

返回示例

{
    "dps": [
        {
            "dpId": 20,
            "value": "false",
            "timeStamp": 1621392860,
            "timeStr": "2021-05-19 10:54:20"
        },
        {
            "dpId": 20,
            "value": "true",
            "timeStamp": 1621392861,
            "timeStr": "2021-05-19 10:54:21"
        },
        {
            "dpId": 20,
            "value": "false",
            "timeStamp": 1621393756,
            "timeStr": "2021-05-19 11:09:16"
        }
    ],
    "hasNext": true,
    "total": 7,
    "dpc": []
}

getLogInSpecifiedTime

获取 DP 点指定时间段上报日志。

请求参数

参数	数据类型	说明	是否必填
devId	String	设备 ID	是
dpIds	String	DP 点 ID，可以是多个 DP，用逗号隔开即可	是
offset	Integer	查询返回结果时从指定序列后的结果开始返回	是
limit	Integer	单页的最大值，offset + limit 要小于等于 4000	是
startTime	String	设备上报的时间，查询起始时间，单位为毫秒	否
endTime	String	设备上报的时间，查询结束时间，单位为毫秒	否
sortType	String	DESC 倒序 或 ASC 顺序	否

返回结果

参数	数据类型	说明
total	number	总数据
dps	Dp[]	见 Dp
hasNext	boolean	是否有下一页

Dp

参数	数据类型	说明
timeStamp	number	上报数据的时间戳格式
dpId	number	dp 点的 id
timeStr	string	根据设备时区转换后的时间格式 yyyy-MM-dd HH:mm:ss
value	string	dp 点的值

请求示例

import { getLogInSpecifiedTime } from '@ray-js/ray';
 
getLogInSpecifiedTime({
  devId: `${YOUR_DEVICE_ID}`,
  dpIds: '25,20', // 多个DP
  offset: 0,
  limit: 3,
  startTime: '',
  endTime: '',
  sortType: 'ASC',
})
  .then((response) => {
    console.log(response);
  })
  .catch();

返回示例

{
    "dps": [
        {
            "dpId": 20,
            "value": "false",
            "timeStamp": 1621392860,
            "timeStr": "2021-05-19 10:54:20"
        },
        {
            "dpId": 20,
            "value": "true",
            "timeStamp": 1621392861,
            "timeStr": "2021-05-19 10:54:21"
        },
        {
            "dpId": 20,
            "value": "false",
            "timeStamp": 1621393756,
            "timeStr": "2021-05-19 11:09:16"
        }
    ],
    "hasNext": true,
    "total": 8,
    "dpc": []
}

getLogUserAction

获取用户操作的下发日志。

请求参数

参数	数据类型	说明	是否必填
devId	String	设备 ID	是
dpIds	String	DP 点 ID，可以是多个 DP，用逗号隔开即可	是
offset	Integer	查询返回结果时从指定序列后的结果开始返回	是
limit	Integer	单页的最大值，offset + limit 要小于等于 4000	是
sortType	String	DESC or ASC	否

返回结果

参数	数据类型	说明
total	number	数据总条数
dps	Dp[]	见 Dp
hasNext	Boolean	是否有下一页

请求示例

import { getLogUserAction } from '@ray-js/ray';
 
getLogUserAction({
  devId: `${YOUR_DEVICE_ID}`,
  dpIds: '20,21', // 多个DP
  offset: 0,
  limit: 3,
  sortType: 'ASC',
})
  .then((response) => {
    console.log(response);
  })
  .catch();

返回示例

{
    "dps": [
        {
            "dpId": 20,
            "value": "false",
            "timeStamp": 1621392860,
            "timeStr": "2021-05-19 10:54:20"
        },
        {
            "dpId": 20,
            "value": "true",
            "timeStamp": 1621392861,
            "timeStr": "2021-05-19 10:54:21"
        },
        {
            "dpId": 20,
            "value": "false",
            "timeStamp": 1621393756,
            "timeStr": "2021-05-19 11:09:16"
        }
    ],
    "hasNext": true,
    "total": 15,
    "dpc": []
}

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