控制台

查询文件列表

GET/v1/files

查询当前账号上传的文件列表。

请求参数

Query类型必填说明
limit: integer可选

返回数量,有效范围 1–200。

offset: integer可选

偏移量,有效范围 0–100000。

返回值

字段类型说明
object: string

固定为 list。

data[].id: string

文件 id,即后续接口使用的 file_id。

data[].object: string

固定为 file。

data[].bytes: integer

文件字节数。

data[].created_at: integer

创建时间,Unix 时间戳,单位为秒。

data[].filename: string

原始文件名。

data[].purpose: string

文件用途标记;可能为空字符串。

data[].status: string

文件状态,以服务端实际返回为准。