---
name: "getAiVisualReportList"
mode: "kit"
versionRequirements:
  - { name: "@tuya-miniapp/cloud-api", version: "1.0.5" }
---

## getAiVisualReportList

> [VERSION] @tuya-miniapp/cloud-api >= 1.0.5

### 描述

查询智能视觉魔方报告列表

### 参数

`Params`

| 参数 | 类型 | 必填 | 默认值 | 描述 |
| --- | --- | --- | --- | --- |
| `params` | `QueryGetAiVisualReportList` | 是 | - | 请求体 |

### 引用对象

##### `type` QueryGetAiVisualReportList

| 属性 | 类型 | 描述 |
| --- | --- | --- |
| `gid` | `string` | 家庭 gid |
| `visionBoxId` | `string` | 视觉魔方 id |
| `offset` | `number` | 分页偏移量 |
| `limit` | `number` | 分页条数 |

##### `enum` ReportType

| 枚举值 | 实际值 | 描述 |
| --- | --- | --- |
| `ReportType.DAILY` | `1` | 日报 |
| `ReportType.WEEKLY` | `2` | 周报 |

##### `interface` EventInfo

| 属性 | 类型 | 描述 |
| --- | --- | --- |
| `eventOrderValue` | `number` | 事件排序值 |
| `eventCode` | `string` | 事件编码 |
| `eventName` | `string` | 事件名称 |
| `eventNum` | `number` | 事件次数 |
| `eventAverageNumPerDay` | `number` | 日均事件次数（可选） |

##### `interface` RelatedFileList

| 属性 | 类型 | 描述 |
| --- | --- | --- |
| `bucket` | `string` | 存储桶 |
| `filePath` | `string` | 文件路径 |
| `signUrl` | `string` | 签名访问地址 |
| `uuid` | `string` | 文件 uuid |


### 示例代码

#### 请求示例

```typescript
import { getAiVisualReportList } from '@tuya-miniapp/cloud-api';

getAiVisualReportList({
  gid: '194137',
  visionBoxId: 'vb-1',
  offset: 0,
  limit: 10,
})
  .then((list) => console.log(list))
  .catch(console.error);
```

#### 返回示例

```json
[
  {
    "visionBoxId": "vb-1",
    "modelName": "model-a",
    "reportId": "r1",
    "reportType": 1,
    "reportTitleName": "日报",
    "summaryAndSuggestion": "",
    "detailTitle": "详情",
    "totalNumTitle": "事件总数",
    "reportState": 1,
    "reportStateName": "已完成"
  }
]
```