上传文件

上传文件，可以上传视频，音频和常见的文件类型
注意事项:

文件大小不得超过30M，且不允许上传空文件
以下示例代码中需要自行替换文件路径和鉴权Token

cURL示例

HTTP示例

POST /open-apis/im/v1/files HTTP/1.1
Host: open.feishu.cn
Authorization: Bearer t-ddf4732fda4aa8a8b1639ee42e8477001d8d5f7c
Content-Type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Length: 471

----WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="file_type"

mp4
----WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="file"; filename="测试视频.mp4"
Content-Type: <Content-Type header here>

(data)
----WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="duration"

3000
----WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="file_name"

测试视频.mp4
----WebKitFormBoundary7MA4YWxkTrZu0gW

Python请求示例

import requests
from requests_toolbelt import MultipartEncoder
# 请注意使用时替换文件path和Authorization
def upload():
  url = "https://open.feishu.cn/open-apis/im/v1/files"
  form = {'file_type': 'stream',
          'file_name': 'text.txt',
          'file':  ('text.txt', open('path/text.txt', 'rb'), 'text/plain')} # 需要替换具体的path  具体的格式参考  https://www.w3school.com.cn/media/media_mimeref.asp
  multi_form = MultipartEncoder(form)
  headers = {
    'Authorization': 'Bearer xxx', ## 获取tenant_access_token, 需要替换为实际的token
  }
  headers['Content-Type'] = multi_form.content_type
  response = requests.request("POST", url, headers=headers, data=multi_form)
  print(response.headers['X-Tt-Logid']) # for debug or oncall
  print(response.content) # Print Response
# Press the green button in the gutter to run the script.

if __name__ == '__main__':
    upload()

请求体示例

---7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="file_type";

mp4
---7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="file_name";

测试视频.mp4
---7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="duration";

3000
---7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="file";
Content-Type: application/octet-stream

二进制文件
---7MA4YWxkTrZu0gW

错误码

HTTP状态码	错误码	描述	排查建议
400	234001	Invalid request param.	检查请求参数是否正确。
401	234002	Unauthorized.	鉴权失败，联系Oncall解决。
400	234006	The file size exceed the max value.	文件大小超出限制(文件:30M; 图片: 10M)。
400	234007	App does not enable bot feature.	应用未启用机器人能力。
400	234010	File's size can't be 0.	请勿上传大小为0的文件。

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

curl --location --request POST 'https://open.feishu.cn/open-apis/im/v1/files' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: multipart/form-data; boundary=---7MA4YWxkTrZu0gW' \ --form 'file_type="mp4"' \ --form 'file_name="测试视频.mp4"' \ --form 'duration="3000"' \ --form 'file=@""'

请求体示例#

错误码#

请求参数

返回响应

请求体示例

错误码