本页目录
常见问题为什么调用云能力会出现失败的情况？

getImageTransferHistory(data: GetImageTransferHistoryParams)

版本要求:
@tuya-miniapp/cloud-api≥1.6.0

描述

游标分页查询图传上传/打印历史记录

参数

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

返回值

类型：Promise<GetImageTransferHistoryResult>
GetImageTransferHistoryResult（含记录列表、是否有下一页及下一页游标）

引用对象

interfaceGetImageTransferHistoryResult查询图传上传/打印历史结果
属性类型描述
记录列表，按时间倒序，仅返回未删除记录
hasMoreboolean是否还有下一页
cursorstring下一页游标，hasMore 为 false 时可为空

示例代码

请求示例

import { getImageTransferHistory } from '@tuya-miniapp/cloud-api';

getImageTransferHistory({
  pageSize: 20,
  deviceId: '6cbed8370dd694e247uk9u',
  homeId: '123456789',
})
  .then(response => {
    console.log(response);
  })
  .catch(error => {
    console.error('Failed to get image transfer history:', error);
  });

返回示例

{
  "list": [
    {
      "id": 101,
      "fileName": "b2f2d6f65eedcfd189bb341e3baa1d28_1722760086681.jpg",
      "objectKey": "tc_permanent/123456789/b2f2d6f65eedcfd189bb341e3baa1d28_1722760086681.jpg",
      "userInput": "我的照片",
      "status": "SUCCESS",
      "gmtCreate": 1722760086681,
      "downloadUrl": {
        "url": "https://example.com/origin.jpg?sign=xxx",
        "thumbnailUrl": "https://example.com/thumbnail.jpg?sign=xxx"
      }
    }
  ],
  "hasMore": false,
  "cursor": ""
}

常见问题

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

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