FILES / API REFERENCE

文件 API

7个接口

上传、下载媒体资源，为消息发送准备文件。本页列出此分组全部 7 个 POST 接口。

全部接口

上传视频。base64 必须是结构完整的 mp4（缺 moov 元数据盒会被拒绝），thumbBase64 是封面图的 base64，width / height 必填。

上传图片（GIF 也走这里）。返回的 data 可整体作为「发送图片」或「发送 GIF」的 content，字段逐个对应。

上传文件。返回的 data 可整体作为「发送文件」的 content；再补一个 voiceTime 就是「发送语音」的 content。

下载媒体文件，返回 base64。fileType 图片传 2（传 1 会报资源不存在）；fileId / aesKey 取自上传接口的返回或消息回调。

上传大文件。传入一个可公网访问的地址，由服务端拉取。

下载大文件。fileId 用 BigFileUploadCompleted 回调事件里的 content.id；不需要 aesKey，这点与普通媒体下载不同。

获取大文件的下载地址。fileId 同「下载大文件」，来自 BigFileUploadCompleted 回调事件。

准备有效 APIKey 和控制台中的 appid，并按具体接口核对必填字段与附加约束。查看接入流程。

本组数据面接口返回能力层原始响应。code = 0 表示请求被接受，实际效果及状态应结合接口说明与查询结果确认。