ユーザークエリ（ページネーション）

line1

https://cn2us02.opapi.win

POST

/api/v1/user/files/list

＃導入

アップロードされたファイルのクエリ

パラメータの説明

フィールド名	タイプ	必須	サンプル値	コメント
ページ	番号	本当	1	ページ番号は 1 以上です
ページサイズ	番号	本当	100	ページサイズ範囲 [1,100]
タグ	配列	偽	[「例」]	クエリファイルタグはオプション
目的	文字列	偽	「例」	クエリされたファイルの目的はオプション
ファイル名	文字列	偽	"例.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
            }
        ]
    }
}

修改于 2025-10-15 08:05:43

ファイルの削除

ユーザーメタデータクエリ (fileUinqueIds による)

ユーザークエリ（ページネーション）

パラメータの説明#

请求参数

返回响应

パラメータの説明