获取已有文件信息¶
根据当前已有的文件元信息
| 方法 | URI |
|---|---|
POST |
/api/v1/files |
请求参数¶
Header¶
| 参数 | 取值 | 说明 |
|---|---|---|
| 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列表 |
样例数据:
响应参数¶
返回值为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 |
请求成功 |