用户查询 (分页)

line1

https://cn2us02.opapi.win

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 的权限

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数application/json

示例

返回响应

🟢200成功

application/json

Body

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://cn2us02.opapi.win/api/v1/user/files/list' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "page": "1",
    "pageSize": "10"
}'

响应示例

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

修改于 2024-11-27 15:48:48

删除文件

用户元数据查询 (by fileUinqueIds)

用户查询 (分页)

简介#

参数描述#

请求参数

返回响应

简介

参数描述