富媒体消息

仅用于在QQ单聊和QQ群聊内，发送图片、视频、语音、文件的相关富媒体资源在消息收发的候使用。 本接口有以下两种使用方式：

1. 当 srv_send_msg = true 时，消息会直接发送到目标端，占用 主动消息频次，超频会发送失败。

2. 当 srv_send_msg = false 时，消息不会直接发送到目标端，返回的 file_info 字段数据，可使用在消息发送接口 media 字段中，file_info 有 过期时间 ，开发者需要自行维护有效期，过期需要重新获得新的 file_info，file_info 不受发送的目标端影响，一个 file_info 可复用发送到多个群或多个用户（注意：用 /v2/groups/{group_openid}/files 上传的文件，仅能发到群聊内，用 /v2/users/{openid}/files 上传的文件，也仅能发送到单聊）。

推荐使用第 2 种方式

用于单聊

• 请求

基本
HTTP URL	/v2/users/{openid}/files
HTTP Method	POST

• 路径参数

属性	类型	必填	说明
openid	string	是	QQ 用户的 openid，可在各类事件中获得。

• 请求参数

属性	类型	必填	说明
file_type	int	是	媒体类型：1 图片，2 视频，3 语音，4 文件（暂不开放） 资源格式要求 图片：png/jpg，视频：mp4，语音：silk
url	string	是	需要发送媒体资源的url
srv_send_msg	bool	是	设置 true 会直接发送消息到目标端，且会占用主动消息频次
file_data		否	【暂未支持】

• 返回参数

属性	类型	说明
file_uuid	string	文件 ID
file_info	string	文件信息，用于发消息接口的 media 字段使用
ttl	int	有效期，表示剩余多少秒到期，到期后 file_info 失效，当等于 0 时，表示可长期使用
id	string	发送消息的唯一ID，当srv_send_msg设置为true时返回

• 错误码

用于群聊

• 请求

基本
HTTP URL	/v2/groups/{group_openid}/files
HTTP Method	POST

• 路径参数

属性	类型	必填	说明
group_openid	string	是	群聊的 openid

• 请求参数

属性	类型	必填	说明
file_type	int	是	媒体类型：1 图片，2 视频，3 语音，4 文件（暂不开放） 资源格式要求 图片：png/jpg，视频：mp4，语音：silk
url	string	是	需要发送媒体资源的url
srv_send_msg	bool	是	设置 true 会直接发送消息到目标端，且会占用主动消息频次
file_data		否	【暂未支持】

• 返回参数

属性	类型	说明
file_uuid	string	文件 ID
file_info	string	文件信息，用于发消息接口的 media 字段使用
ttl	int	有效期，表示剩余多少秒到期，到期后 file_info 失效，当等于 0 时，表示可长期使用
id	string	发送消息的唯一ID，当srv_send_msg设置为true时返回