下载文件
通过已上传文件的 Key 下载文件。
前提条件
应用需要开启机器人能力。
使用限制
- 只能下载由当前机器人上传的文件。
- 下载的资源大小不能超过 100 MB。
- 该接口仅适用于通过文件的 Key 下载文件。如果你需要下载用户发送消息内的资源文件，可使用获取消息中的资源文件接口。
- 如果需要 Content-Disposition header，发起请求时需要在 header 中设置 Content-Type 为 application/json。
请求
| 项目 | 值 |
|---|---|
| HTTP URL | https://open.feishu.cn/open-apis/im/v1/files/:file_key |
| HTTP Method | GET |
| 接口频率限制 | 1000 次/分钟、50 次/秒 |
| 支持的应用类型 | custom,isv |
| 权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用 | 无 |
请求头
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| Authorization | string | 是 | tenant_access_token 值格式："Bearer access_token" 示例值："Bearer t-7f1bcd13fc57d46bac21793a18e560" 了解更多：如何选择与获取 access token |
路径参数
| 名称 | 类型 | 描述 |
|---|---|---|
file_key | string | 文件的 Key，通过上传文件接口上传文件后，从返回结果中获取。 示例值："file_456a92d6-c6ea-4de4-ac3f-7afcf44ac78g" |
响应
HTTP状态码为 200 时，表示成功
返回文件二进制流
错误码
| HTTP状态码 | 错误码 | 描述 | 排查建议 |
|---|---|---|---|
| 400 | 234001 | Invalid request param. | 请求参数无效，请根据接口文档描述检查请求参数是否正确。 |
| 401 | 234002 | Unauthorized. | 接口鉴权失败，请咨询技术支持。 |
| 400 | 234008 | The app is not the resource sender | 当前应用不是资源的所有者，无法进行操作。 |
| 400 | 234005 | Image has been deleted | 资源不存在，无法进行操作。 |
| 400 | 234037 | Downloaded file size exceeds limit. | 资源大小超过 100 MB 时无法下载。 |
| 400 | 234041 | Tenant master key has been deleted, please contact the tenant administrator. | 租户加密密钥被删除，被加密的数据无法操作，请联系租户管理员。 |
| 400 | 234042 | Hybrid deployment tenant storage error, such as full storage space, please contact tenant administrator. | 租户的自定义存储发生错误，如存储空间已满等。请联系租户管理员或技术支持。 |
更多错误码信息，参见通用错误码。