获取消息中的资源文件
获取指定消息内包含的资源文件，包括音频、视频、图片和文件。成功调用后，返回二进制文件流下载文件。
前提条件
- 应用需要开启机器人能力。
- 机器人和待操作的消息需要在同一会话内。
使用限制
- 仅支持下载 100 MB 以内的资源文件。
- 暂不支持获取表情包资源。
- 暂不支持获取合并转发消息中的子消息、卡片消息中的资源文件。如果请求时传入了合并转发消息或子消息的 ID、卡片消息 ID，则会返回错误码 234043。
- 不支持在当前接口内调整文件格式，你可以获取资源文件后，在本地自行调整。
请求
| 项目 | 值 |
|---|---|
| HTTP URL | https://open.feishu.cn/open-apis/im/v1/messages/:message_id/resources/:file_key |
| HTTP Method | GET |
| 接口频率限制 | 1000 次/分钟、50 次/秒 |
| 支持的应用类型 | custom,isv |
| 权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用 开启任一权限即可 | im:message 获取与发送单聊、群组消息 im:message:readonly 获取单聊、群组消息 im:message.history:readonly 获取单聊、群组的历史消息 |
请求头
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| Authorization | string | 是 | tenant_access_token 值格式："Bearer access_token" 示例值："Bearer t-7f1bcd13fc57d46bac21793a18e560" 了解更多：如何选择与获取 access token |
路径参数
| 名称 | 类型 | 描述 |
|---|---|---|
message_id | string | 待查询的消息 ID。ID 获取方式： - 调用发送消息接口后，从响应结果的 message_id 参数获取。 - 监听接收消息事件，当触发该事件后可以从事件体内获取消息的 message_id。 - 调用获取会话历史消息接口，从响应结果的 message_id 参数获取。示例值："om_dc13264520392913993dd051dba21dcf" |
file_key | string | 待查询资源的 Key。你可以调用获取指定消息的内容接口，通过消息 ID 获取消息内容中的资源 Key。 注意：路径参数 file_key 和 message_id 需要匹配。示例值："file_456a92d6-c6ea-4de4-ac3f-7afcf44ac78g" |
查询参数
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
type | string | 是 | 资源类型 可选值有： - image：对应消息中的图片或富文本消息中的图片。 - file：对应消息中的文件、音频、视频（表情包除外）。示例值：image |
响应
Note 文件类型可通过响应头（Response Header）中的
Content-Type字段获取。
HTTP状态码为 200 时，表示成功
返回文件二进制流
错误码
| HTTP状态码 | 错误码 | 描述 | 排查建议 |
|---|---|---|---|
| 400 | 230110 | Action unavailable as the message has been deleted. | 消息已删除，无法执行操作。 |
| 400 | 234001 | Invalid request param. | 请求参数无效。请参考文档参数描述，检查请求参数是否填写正确。 |
| 401 | 234002 | Unauthorized. | 鉴权失败，请咨询技术支持。 |
| 400 | 234003 | File not in message. | 该资源不属于当前消息。请检查消息 ID 和资源 Key，两者必须相匹配。 |
| 400 | 234004 | App not in chat. | 应用不在消息所在的群组中。你需要将应用机器人添加到当前消息所在群组中，或者修改正确的消息 ID。 |
| 400 | 234009 | Lack of necessary permissions. | 暂不支持在外部群中进行本操作。 |
| 400 | 234019 | scope CheckAppTenant fail. | 未获取到应用的权限信息，请重试。 |
| 400 | 234037 | Downloaded file size exceeds limit. | 下载的资源大小不允许超过 100 MB。 |
| 400 | 234038 | Do not allow downloading of message resources in restricted mode. | 不能下载保密消息中的资源文件，请检查消息是否已被设置为保密，或群组开启了防泄密模式。 |
| 400 | 234040 | The message is invisible to the operator. | 该消息对当前操作者不可见，请联系群主或群管理员检查群设置中是否关闭了 新成员可查看历史消息。 |
| 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. | 请求出现混部租户存储错误，如存储空间已满等，请联系企业的管理员或技术支持。 |
| 400 | 234043 | Unsupported message type. | 不支持的消息类型，如合并转发消息（包括子消息）、消息卡片。 |
更多错误码信息，参见通用错误码。