查询文件列表

GET 
/openapi/2026-01/file

分页返回文件列表。

请求

Query参数

folder string

文件夹

cursor string

分页游标

page_size int32

每页记录数

page int32

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

响应

200

OK

application/json

数据结构

数据结构

codestring

错误码

messagestring

错误信息

data object

files object[]

文件列表

Array [

upload_linkstring

上传文件链接

file_uristring

文件 URI

folderstring

文件夹

sizeint32

文件大小

typestring

文件类型

origin_linkstring

原始链接

descstring

文件描述

aspect_ratiostring

文件宽高比

widthint32

文件宽度

heightint32

文件高度

created_atstring

创建时间

updated_atstring

更新时间

]

cursorstring

分页游标

has_moreboolean

是否有更多记录

totalint32

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

示例

{
  "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
  }
}