跳转至

获取已有文件信息

根据当前已有的文件元信息

方法 URI
POST /api/v1/files

请求参数

参数 取值 说明
Content-Type application/json 指定请求正文的数据格式。当值为 application/json 时,表明请求体(Body)内容以 JSON 格式组织,服务端将按 JSON 规范解析请求参数。
X-TraceId string traceId
Authorization Bearer $AccessToken 用于验证客户端身份的访问令牌

Query Params

Request Body

参数 类型 说明 备注
user_id string 用户的唯一标识 USER_ID
file_ids list 可选,用于过滤的文件ID列表

样例数据:

{
  "user_id": "string",
  "file_ids": [
    "string"
  ]
}

响应参数

返回值为json array,每个json对象包含如下字段:

参数 类型 说明 备注
id string 文件ID
name string 文件名
type string 文件类型
creation_time int 创建时间戳,格式为unix epoch时间 1740558966

样例数据:

[
  {
    "id": "FILE_ID",
    "name": "document.pdf",
    "type": "application/pdf",
    "creation_time": 1740558966
  }
]

状态码

状态码 说明
200 请求成功