用户查询 (分页)

POST/api/v1/user/files/list

简介

查询已上传文件

参数描述

字段名	类型	必需	示例值	备注
page	number	true	1	页码大于等于1
pageSize	number	true	100	页大小范围 [1,100]
tags	array	false	["example"]	查询的文件Tag 可选
purpose	string	false	"example"	查询的文件用途可选
filename	string	false	"example.txt"	查询的文件名可选

调用此接口需要提供有效的APIKey凭证，如果启用了APIKey权限检查，需要具备 file-v1 的权限

请求参数

page

number

页码

必需

页码大于等于1

pageSize

number

页大小

必需

页大小范围 [1,100]

filename

string

文件名

可选

查询的文件名可选

示例代码

返回响应

成功(200)

HTTP 状态码: 200

内容格式: JSONapplication/json

object {0}

{
  "statusCode": 200,
  "message": "List Files Success",
  "data": {
    "total": 2,
    "current_page": 1,
    "page_size": 10,
    "total_pages": 1,
    "items": [
      {
        "user_id": "1",
        "file_name": "new-pic.jpg",
        "purpose": 0,
        "uploaded_at": "2024-11-27T14:22:11.286Z",
        "update_at": "2024-11-27T15:07:49.897Z",
        "expires_at": null,
        "file_size": "2241667",
        "mime_type": "image/jpeg",
        "tags": [],
        "file_unique_id": "ENthMCy_5zr5zN3GRJseM",
        "status": 2,
        "is_public": true,
        "share_enabled": false,
        "share_path": null,
        "share_expires_at": null,
        "access_secret_enabled": false,
        "access_secret": null,
        "share_view_count": 0,
        "share_dl_count": 0
      },
      {
        "user_id": "1",
        "file_name": "GdIDB9HakAAiVFK.jpg",
        "purpose": 0,
        "uploaded_at": "2024-11-27T11:14:03.806Z",
        "update_at": "2024-11-27T11:14:03.806Z",
        "expires_at": null,
        "file_size": "2241667",
        "mime_type": "image/jpeg",
        "tags": null,
        "file_unique_id": "Jmjq5JctrOPGBWop7sUOi",
        "status": 2,
        "is_public": true,
        "share_enabled": false,
        "share_path": null,
        "share_expires_at": null,
        "access_secret_enabled": false,
        "access_secret": null,
        "share_view_count": 0,
        "share_dl_count": 0
      }
    ]
  }
}

最后修改时间： 7 天前