用户元数据查询 (by fileUinqueIds)

line1

https://cn2us02.opapi.win

POST

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

简介

根据fileId查询已上传文件的元数据

参数描述

字段名	类型	必需	示例值	备注
fileUniqueIds	string	true	["ENthMCy_5zr5zN3GRJseM"]	查询的Id

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

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

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

fileUniqueIds

array[string]

文件IDs

必需

示例值:

["X7DWcPTJ4mhxwepEJ1z34","RZEruBJFEvoOz8NYKusfD"]

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

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

返回响应

🟢200成功

application/json

Body

object {0}

示例

成功示例异常示例(400)

{
    "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-05-21 08:57:08

用户查询 (分页)

文件下载接口（Public公开文件下载）

用户元数据查询 (by fileUinqueIds)

简介#

参数描述#

请求参数

示例代码

返回响应

简介

参数描述