飞书 API

下载文件

GET

/open-apis/im/v1/files/{file_key}

下载文件接口，只能下载应用自己上传的文件
注意事项:

需要开启机器人能力

只能下载机器人自己上传的文件

下载用户发送的资源，请使用获取消息中的资源文件接口

下载的资源大小不能超过100M

如果需要Content-Disposition header，发起请求的时候需要在header中设置Content-Type为application/json

错误码

HTTP状态码	错误码	描述	排查建议
400	234001	Invalid request param.	检查请求参数是否正确。
401	234002	Unauthorized.	鉴权失败，联系Oncall解决。
400	234008	The app is not the resource sender	应用不是资源的所有者。
400	234005	Image has been deleted	资源不存在。
400	234037	Downloaded file size exceeds limit.	不允许下载的资源大小超过100MB限制。

请求示例

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://open.feishu.cn/open-apis/im/v1/files/file_456a92d6-c6ea-4de4-ac3f-7afcf44ac78g' \
--header 'Authorization;'

响应示例

HTTP状态码为200时，表示成功
返回文件二进制流

请求参数

Path 参数

file_key

必需

文件的key，通过上传文件接口上传图片后获得

示例值:

file_456a92d6-c6ea-4de4-ac3f-7afcf44ac78g

Header 参数

Authorization

string

必需

tenant_access_token 或 user_access_token 值格式："Bearer access_token" 示例值："Bearer u-7f1bcd13fc57d46bac21793a18e560"

默认值:

Bearer {{access_token}}

Content-Type

string

必需

固定值："application/json; charset=utf-8"

默认值:

application/json; charset=utf-8

Body 参数application/x-www-form-urlencoded

object {0}

返回响应

🟢200200 Success

application/json

Body

object {0}

修改于 2023-01-12 09:40:50

上传文件

资源介绍

下载文件

错误码#

请求参数

返回响应

错误码