网易云信 IM 提供文件上传的能力。

调用频率

单个应用默认最高调用频率请参考 频控说明。

请求信息

请求 URL

POST https://{endpoint}/im/v2/tools/files

请求 URL 中的 {endpoint} 代表服务地址域名，您可以根据用户服务区域选择中国大陆和海外服务地址，并支持搭建高可用主备域名机制。详情请参考 调用方式 服务地址章节。

请求头参数

请求 Header 的参数说明请参考 请求 Header。

该接口请求头中的 Content-Type 为 application/octet-stream。

查询参数

参数名称	类型	是否必选	描述
operator_account_id	String	是	操作者账号 ID。
chunk_number	Integer	是	当前分片的序号（从 1 开始），取值范围为 1～10000。 单个分片的的大小限制为 5M~15M。最后一个分片不做限制。
finish	Boolean	是	是否为最后一个分片，true 表示是。
context	String	否	上传上下文，主要用于存储上传的相关信息。 该字段是只能被上传服务器解读使用的不透明字段，上传端不应修改其内容。 该字段为空表示第一次上传，后续上传剩余部分数据都需要带上该参数。
media_type	String	否	上传文件类型，表示请求内容的类型。例如：image/jpeg。 仅需第一次上传时传入，后续传入无效。
size	long	否	整个文件的总大小。 仅需第一次上传时传入，后续传入无效。 最大能上传 15M 的文件。
secure	Boolean	否	指定返回的 URL 是否使用安全协议（HTTPS）。true（默认）表示返回 HTTPS URL；false 表示返回 HTTP URL。 仅需第一次上传时传入，后续传入无效。
expire_time	Integer	否	过期时间，单位秒。默认不过期，最小值为 24 小时。 仅需第一次上传时传入，后续传入无效。
tag	String	否	文件的应用场景，最多 32 个字符。 仅需第一次上传时传入，后续传入无效。

请求示例

POST https://{{endpoind}}/im/v2/files?complete=false&operator_account_id=yx1&chunk_number=1&chunk_md5=xxx&type&media_type=image/jpeg&size=1111111
AppKey:xxxx
CurTime:1443592222
CheckSum:xxxx
Content-Length: 12000
Content-Type: application/octet-stream
Date: Wed, 01 Mar 2016 21:34:55 GMT                                                                                                                                     

<data of body>

响应信息

响应头参数

响应 Header 的参数说明请参考 响应 Header。

响应体参数

参数名称	类型	说明	是否必返回
code	Integer	状态码，200 表示请求成功。	是
msg	String	提示信息。请求失败时返回错误信息，请求成功时返回 "success"。	是
- data	Object	返回的 JSON 数据对象，请求失败则返回空对象。	是
context	String	上传的上下文。	是
chunk_number	Integer	当前分片的序号。	是
url	String	最后一个分片返回。	否

响应体示例

JSON{
    "code": 200,
    "msg": "success",
    "data": {
        "context": "上下文",
        "chunk_number": 1
    }
}

错误码

错误码	错误码描述	错误信息示例
200	请求成功	success
414	参数错误	parameter error
500	服务器内部错误	internal server error