Skip to content

上传图片

词条图片资源上传。

请求

项目
HTTP URLhttps://open.feishu.cn/open-apis/lingo/v1/files/upload
HTTP MethodPOST
接口频率限制1000 次/分钟、50 次/秒
支持的应用类型custom
权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用 开启任一权限即可baike:entity 查看、创建、编辑、删除词典词条 baike:entity:exempt_review 创建、更新词典免审词条

请求头

名称类型必填描述
Authorizationstringtenant_access_tokenuser_access_token 值格式:"Bearer access_token" 示例值:"Bearer u-7f1bcd13fc57d46bac21793a18e560" 了解更多:如何选择与获取 access token
Content-Typestring示例值:"multipart/form-data; boundary=---7MA4YWxkTrZu0gW"

请求体

名称类型必填描述
namestring文件名称,当前仅支持上传图片且图片格式为以下六种:icon、bmp、gif、png、jpeg、webp
示例值:"示例图片.png"
数据校验规则
- 长度范围:1100 字符
filefile二进制文件内容,高宽像素在 320-4096 像素之间,大小在 3KB-10MB 的图片
示例值:file binary

请求体示例

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

示例图片.png
---7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="file";
Content-Type: application/octet-stream

file binary
---7MA4YWxkTrZu0gW

响应

响应体

名称类型描述
codeint错误码,非 0 表示失败
msgstring错误描述
data\--
  └ file_tokenstring文件 token

响应体示例

json
{
    "code": 0,
    "msg": "success",
    "data": {
        "file_token": "boxbcEcmKiD****vgqWTpvdc7jc"
    }
}

错误码

HTTP状态码错误码描述排查建议
4002250001invalid param参数错误,参考文档检查输入参数
5002250002network anomaly, please try again多数请求是服务超时,请重新请求,少数是服务异常请咨询客服

内容来源:飞书开放平台 · 自动爬取整理