飞书 API

写入图片

POST

/open-apis/sheets/v2/spreadsheets/{spreadsheetToken}/values_image

自建应用商店应用

该接口用于根据 spreadsheetToken 和 range 向单个格子写入图片。

错误码

具体可参考：服务端错误码说明

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://open.feishu.cn/open-apis/sheets/v2/spreadsheets//values_image' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{ 
    "range": "string", 
    "image": [123,32,42,23],
    "name": "xxx.png"
}'

响应示例

{
  "code": 0,
  "data": {
    "revision": "int",
    "spreadsheetToken": "***",
    "updateRange": "string"
  },
  "msg": "success"
}

请求参数

Path 参数

spreadsheetToken

string

必需

Header 参数

Authorization

string

必需

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

默认值:

Bearer {{access_token}}

Content-Type

string

必需

固定值："application/json; charset=utf-8"

默认值:

application/json; charset=utf-8

Body 参数application/json

range

string

必需

查询范围 range=!<开始格子>:<结束格子> 如：xxxx!A1:D5，详见在线表格开发指南。此处限定为一个格子，如: xxxx!A1:A1

image

array[integer]

必需

需要写入的图片二进制流，支持 "PNG", "JPEG", "JPG", "GIF", "BMP", "JFIF", "EXIF", "TIFF", "BPG", "WEBP", "HEIC" 等图片格式

name

string

写入的图片名字

必需

示例

返回响应

🟢200成功

application/json

Body

code

integer

必需

data

object

必需

spreadsheetToken

string

必需

spreadsheet 的 token

revision

string

必需

spreadsheet 的版本号

updateRange

string

必需

写入图片的range

msg

string

必需

修改于 2023-01-18 05:59:20

批量设置单元格样式

合并单元格

写入图片

错误码#

请求参数

返回响应

错误码