百宝箱开放平台 ✖️ 文件查询-阿里云开发者社区

百宝箱开放平台 ✖️ 文件查询

2025-10-20 90

版权

本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。

简介： 本接口用于查询通过文件上传接口提交的文件详情，需在应用发布后，使用有效fileId及授权令牌调用，支持返回文件名、类型、大小、创建时间等信息。

调用本接口，开发者可以查询通过文件上传接口上传的文件详情信息。

前提条件

在调用本接口前，请先完成下述事项：

完成应用的发布，若无，请参见：发布应用，完成相关事项。
完成文件上传，并记录对应的 fileId。若无，请参见：文件上传，完成相关事项。

请求地址

GEThttps://api.tbox.cn/api/file/retrieve?fileId={fileId}

请求头

参数名称	是否必填	参数类型	描述	示例值
Authorization	是	string	用于验证客户端身份的访问令牌，你可以在百宝箱中获取，获取方式可参见：授权管理。	`PAT_2J40**********THUIVRH1`
Content-Type	是	string	指定返回数据的格式	`application/json`

请求参数

参数名称	是否必填	参数类型	描述	示例值
fileId	是	string	已上传的文件 ID	`123ddf32ddd`

请求示例

curl -X GET 'https://api.tbox.cn/api/file/retrieve?fileId=123ddf32ddd' \
-H "Authorization: ${token}" \
-H "Content-Type: application/json"

返回参数

参数名称	参数类型	描述	示例值
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"
}

百宝箱开放平台 ✖️ 文件查询

前提条件

请求地址

请求头

请求参数

请求示例

返回参数

返回示例

相关阅读

物联网

热门文章

最新文章

相关电子书