Skip to content

删除浮动图片

删除电子表格工作表内指定的浮动图片。

请求

项目
HTTP URLhttps://open.feishu.cn/open-apis/sheets/v3/spreadsheets/:spreadsheet_token/sheets/:sheet_id/float_images/:float_image_id
HTTP MethodDELETE
接口频率限制100 次/分钟
支持的应用类型custom,isv
权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用 开启任一权限即可drive:drive 查看、评论、编辑和管理云空间中所有文件 sheets:spreadsheet 查看、评论、编辑和管理电子表格 sheets:spreadsheet:write_only 编辑电子表格

请求头

名称类型必填描述
Authorizationstringtenant_access_tokenuser_access_token 值格式:"Bearer access_token" 示例值:"Bearer u-7f1bcd13fc57d46bac21793a18e560" 了解更多:如何选择与获取 access token

路径参数

名称类型描述
spreadsheet_tokenstring电子表格的 token。可通过以下两种方式获取。了解更多,参考电子表格概述。 - 电子表格的 URL:https://sample.feishu.cn/sheets/==Iow7sNNEphp3WbtnbCscPqabcef== - 调用获取文件夹中的文件清单
示例值:"Iow7sNNEphp3WbtnbCscPqabcef"
sheet_idstring电子表格工作表的 ID。调用获取工作表获取 ID。
示例值:"0beg12"
float_image_idstring工作表内浮动图片的唯一标识。通过查询浮动图片接口获取。
示例值:"ye06SS14ph"

cURL 请求示例

bash
curl --location --request DELETE 'https://open.feishu.cn/open-apis/sheets/v3/spreadsheets/shtbchuIXPxjaYxsZzQxBqxxxxx/sheets/ea131a/float_images/ye06SS14pr' \
--header 'Authorization: Bearer t-384c15ba0644b82caecec91553386563c814c4b9' \
--header 'Content-Type: application/json'

响应

响应体

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

响应体示例

json
{
    "code": 0,
    "msg": "success",
    "data": {}
}

错误码

HTTP状态码错误码描述排查建议
4001310243Wrong Float Image Id浮动图片 ID 错误,请检查 float_image_id 参数是否填写正确
4001310229Wrong URL Param检查 URL 中的路径参数是否填写正确
4001310213Permission Fail没有文档权限。参考云文档常见问题问题 3 开通文档权限
4001310217Too Many Request请求发送过于频繁,请稍后重试
4001310214SpreadSheet Not Found电子表格 token 不存在。请检查表格 token 是否填写
4001310215Sheet Id Not Found工作表 ID 不存在。请检查工作表 ID 是否填写
4001310235Retry Later稍后重试
5001315201Server Error服务内部错误,请l联系技术支持
5001315203Server Error服务内部错误,请l联系技术支持
4001310242In Mix state当前表格数据位于用户机房,正在将数据恢复到 SaaS 环境中,请稍后重试
4001310249Spreadsheet Deleted电子表格被删除,请恢复表格后重试

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