exportDeviceData – 涂鸦小程序

exportDeviceData(params: ExportDeviceDataParams)

版本要求:

@tuya-miniapp/cloud-api≥1.3.0

描述

按时间范围将设备能源数据导出并发送至指定邮箱。支持一次导出多个指标，导出任务为异步操作，接口返回成功仅表示任务提交成功，实际邮件将在后台处理后发出。

参数

参数	类型	必填	说明
		是	请求参数

返回值

类型：Promise<boolean>

是否成功提交导出任务；返回 true 仅代表任务已提交，邮件发送为异步，实际收到邮件可能有延迟

引用对象

enumDateType

枚举值	实际值	描述
`DateType.Hour`	`hour`	小时维度，日期格式为 `YYYYMMDDHH`，如 `2026010108`
`DateType.Day`	`day`	天维度，日期格式为 `YYYYMMDD`，如 `20260101`
`DateType.Month`	`month`	月维度，日期格式为 `YYYYMM`，如 `202601`

enumIndicatorCode

枚举值	实际值	描述
`IndicatorCode.EleUsage`	`ele_usage`	用电量
`IndicatorCode.EleCost`	`ele_cost`	电费

合法值

`DateType`

值	说明	最低版本
`hour`	小时维度，日期格式为 `YYYYMMDDHH`，如 `2026010108`	-
`day`	天维度，日期格式为 `YYYYMMDD`，如 `20260101`	-
`month`	月维度，日期格式为 `YYYYMM`，如 `202601`	-

`IndicatorCode`

值	说明	最低版本
`ele_usage`	用电量	-
`ele_cost`	电费	-

示例代码

请求示例

import { exportDeviceData, IndicatorCode, DateType } from '@tuya-miniapp/cloud-api';

exportDeviceData({
  devId: 'vdevo123',
  dateType: DateType.Month,
  beginDate: '202601',
  endDate: '202603',
  email: 'demo@*.com',
  indicatorCodes: [IndicatorCode.EleUsage, IndicatorCode.EleCost],
})
  .then(result => {
    console.log('导出任务提交成功:', result);
  })
  .catch(error => {
    console.error('导出任务提交失败:', error);
  });

返回示例

true

常见问题

为什么调用云能力会出现失败的情况？

使用本接口前，请确保设备所属产品已在涂鸦 IoT 开发平台开启电量统计高级能力。未启用该能力的产品无法采集电量/电费数据，接口将返回空数据或报错。如需使用，请创建带有电量/电费统计功能的产品，并在产品详情中启用相应高级能力。同时，接口依赖云能力，需在小程序开发者平台开发设置 - 云能力进行授权配置。