上传文件

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

文件大小不得超过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的文件。

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

请求参数

Header 参数

Content-Type

必需

示例值："multipart/form-data; boundary=---7MA4YWxkTrZu0gW"

示例值:

multipart/form-data; boundary=---7MA4YWxkTrZu0gW

Authorization

string

必需

tenant_access_token 或 user_access_token 值格式："Bearer access_token" 示例值："Bearer u-7f1bcd13fc57d46bac21793a18e560"

默认值:

Bearer {{access_token}}

Body 参数multipart/form-data

file_type

必需

文件类型,可选的类型有mp4,pdf,doc示例值："mp4"

示例值:

mp4

file_name

必需

带后缀的文件名示例值："测试视频.mp4"

示例值:

测试视频.mp4

duration

可选

文件的时长(视频，音频),单位:毫秒

示例值：3000

示例值:

3000

file

必需

文件内容

示例值：二进制文件

application/json

Body

code

integer

必需

错误码，非 0 表示失败

msg

string

错误描述

必需

data

object

必需

file_key

string

文件的key

必需

请求体示例#

错误码#

请求参数

返回响应

请求体示例

错误码