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

line1

https://cn2us02.opapi.win

POST

/api/v1/user/files/get-metadata

＃導入

fileIdに基づいてアップロードされたファイルのメタデータをクエリします。

パラメータの説明

フィールド名	タイプ	必須	サンプル値	コメント
ファイル固有 ID	文字列	本当	["ENthMCy_5zr5zN3GRJseM"]	クエリ ID

このインターフェイスを呼び出すには、有効な APIKey 資格情報を提供する必要があります。 APIKey 権限チェックが有効になっている場合は、「file-v1」権限が必要です。

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Body 参数application/x-www-form-urlencoded

返回响应

🟢200成功

application/json

Body

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://cn2us02.opapi.win/api/v1/user/files/get-metadata' \
--header 'Authorization: Bearer <token>' \
--data-urlencode 'fileUniqueIds=X7DWcPTJ4mhxwepEJ1z34' \
--data-urlencode 'fileUniqueIds=RZEruBJFEvoOz8NYKusfD'

响应示例

成功例

{
    "statusCode": 200,
    "message": "Get File Metadata Success",
    "data": [
        {
            "user_id": "1",
            "file_name": "ohmygpt-logo-black.svg",
            "purpose": 0,
            "uploaded_at": "2025-02-08T12:31:46.189Z",
            "update_at": "2025-02-08T12:31:46.189Z",
            "expires_at": null,
            "file_size": "2430",
            "mime_type": "image/svg+xml",
            "tags": null,
            "file_unique_id": "RZEruBJFEvoOz8NYKusfD",
            "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": "ohmygpt-logo-black.png",
            "purpose": 0,
            "uploaded_at": "2025-02-09T11:40:50.086Z",
            "update_at": "2025-02-09T11:40:50.086Z",
            "expires_at": null,
            "file_size": "1965",
            "mime_type": "image/png",
            "tags": null,
            "file_unique_id": "X7DWcPTJ4mhxwepEJ1z34",
            "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 による)

パラメータの説明#

请求参数

返回响应

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

パラメータの説明