Skip to main content
GET
通过ID获取文件元数据

概述

使用此端点,你可以通过文件的唯一标识符(ID)检索文件的元数据。元数据包括文件的名称、大小、创建日期等信息。

请求

HTTP 请求

GET /v1/files/{file_id}

路径参数

  • file_id (string): 需要检索的文件的唯一标识符。

响应

成功的响应将返回一个包含文件元数据的 JSON 对象。

响应示例

错误

如果请求的文件不存在,API 将返回一个错误响应。

错误示例

相关端点

备注

确保在请求中提供有效的 file_id,否则将无法检索到文件的元数据。

授权

Authorization
string
header
必填

Bearer认证头格式为Bearer ,其中是你的认证令牌。

路径参数

file_id
string
必填

要检索的文件的唯一标识符。

响应

成功响应文件元数据。

id
string

文件 ID

object
string

对象类型。此端点为 "file"。

created
integer

创建的纪元时间戳

filename
string

上传文件的文件名

bytes
integer

文件大小(字节)

purpose
string

文件的用途

status
string

文件状态(例如,"pending","completed")