跳转到主要内容
GET
/
v1
/
files
/
{file_id}
通过ID获取文件元数据
curl --request GET \
  --url https://api.olostep.com/v1/files/{file_id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "<string>",
  "object": "<string>",
  "created": 123,
  "filename": "<string>",
  "bytes": 123,
  "purpose": "<string>",
  "status": "<string>"
}

​
获取文件

通过文件的唯一标识符（ID）检索文件的元数据。

​
请求

GET /v1/files/{file_id}

​
路径参数

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

​
响应

成功的响应将返回以下字段：
  • id (string): 文件的唯一标识符。
  • name (string): 文件的名称。
  • size (integer): 文件的大小（以字节为单位）。
  • created_at (string): 文件创建的时间戳。
  • updated_at (string): 文件最后更新的时间戳。

​
示例

curl -X GET https://api.olostep.com/v1/files/12345 \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

{
  "id": "12345",
  "name": "example.txt",
  "size": 1024,
  "created_at": "2023-10-01T12:00:00Z",
  "updated_at": "2023-10-02T12:00:00Z"
}

​
错误

如果请求失败，可能会返回以下错误代码：
  • 404 Not Found: 文件ID不存在。
  • 401 Unauthorized: 访问令牌无效或已过期。

授权

​
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"）