文件查询
调用本接口，开发者可以查询通过文件上传接口上传的文件详情信息。
前提条件
在调用本接口前，请先完成下述事项：
- 完成应用的发布，若无，请参见：发布应用，完成相关事项。
- 完成文件上传，并记录对应的 fileId。
请求地址
GET``https://api.tbox.cn/api/file/retrieve?fileId={fileId}
请求头
| 参数名称 | 是否必填 | 参数类型 | 描述 | 示例值 |
|---|---|---|---|---|
| Authorization | 是 | string | 用于验证客户端身份的访问令牌，你可以在百宝箱中获取，获取方式可参见：授权管理。 | PAT_2J40**********THUIVRH1 |
| Content-Type | 是 | string | 指定返回数据的格式 | application/json |
请求参数
| 参数名称 | 是否必填 | 参数类型 | 描述 | 示例值 |
|---|---|---|---|---|
| fileId | 是 | string | 已上传的文件 ID | 123ddf32ddd |
请求示例返回参数
| 参数名称 | 参数类型 | 描述 | 示例值 |
|---|---|---|---|
| errorCode | String | 状态码，非 0 表示失败 | 0 |
| errorMsg | String | 状态描述 | success |
| data | object | 文件详情对象 | 见下方示例 |
| data.id | string | 文件 ID | 123ddf32ddd |
| data.fileName | string | 文件名 | test.txt |
| data.fileType | string | 文件类型 | txt |
| data.bytes | string | 文件大小（字节数） | 1024846 |
| data.gmtCreate | string | 文件创建时间 | 2025-07-18 15:29:08 |
| traceId | String | 本次请求的唯一标识 | 0be8ed*********44067999e8721 |
返回示例
成功示例
{
"data": {
"bytes": 666,
"fileName": "test.txt",
"fileType": "txt",
"gmtCreate": "2025-08-04 23:04:37",
"id": "123ddf32ddd"
},
"errorCode": "0",
"errorMsg": "success",
"traceId": "0b446a2817550027034776634e09f1"
}
失败示例
{
"errorCode": "P_1_02_111",
"errorMsg": "资源不存在",
"solution": "",
"traceId": "0be8ed2517550025084902701ec9f5"
}
