User metadata query (by fileUinqueIds)

line1

https://cn2us02.opapi.win

POST

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

Introduction

Query the metadata of uploaded files based on fileId

Parameter description

Field name	Type	Required	Sample value	Comments
fileUniqueIds	string	true	["ENthMCy_5zr5zN3GRJseM"]	Query Id

Calling this interface requires providing valid APIKey credentials. If APIKey permission check is enabled, you need to have file-v1 permissions.

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

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

返回响应

🟢200success

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'

响应示例

Successful Examples

{
    "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:07:30

User query (pagination)

File download interface (Public file download)

User metadata query (by fileUinqueIds)

Introduction#

Parameter description#

请求参数

返回响应

Introduction

Parameter description