**版本：202601**

# 查询文件列表

**GET** `/openapi/2026-01/file`

分页返回文件列表。

## 请求

**Query参数**

- `folder` string

  文件夹
- `cursor` string

  分页游标
- `page_size` int32

  每页记录数
- `page` int32

  页码（从 1 开始），与 cursor 互斥

## 响应

**200**

OK

**application/json**

**数据结构 | 示例**

**数据结构**

- `code` string

  错误码
- `message` string

  错误信息
- `data` object

  - `files` object[]

    文件列表

    *   Array \[

    - `upload_link` string

      上传文件链接
    - `file_uri` string

      文件 URI
    - `folder` string

      文件夹
    - `size` int32

      文件大小
    - `type` string

      文件类型
    - `origin_link` string

      原始链接
    - `desc` string

      文件描述
    - `aspect_ratio` string

      文件宽高比
    - `width` int32

      文件宽度
    - `height` int32

      文件高度
    - `created_at` string

      创建时间
    - `updated_at` string

      更新时间
    *   \]
  - `cursor` string

    分页游标
  - `has_more` boolean

    是否有更多记录
  - `total` int32

    全部页的总记录数(供 page 模式分页计算总页数)

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "files": [
      {
        "upload_link": "string",
        "file_uri": "string",
        "folder": "string",
        "size": 0,
        "type": "string",
        "origin_link": "string",
        "desc": "string",
        "aspect_ratio": "string",
        "width": 0,
        "height": 0,
        "created_at": "string",
        "updated_at": "string"
      }
    ],
    "cursor": "string",
    "has_more": true,
    "total": 0
  }
}
```