批量更新块
PATCH
https://open.feishu.cn/open-apis/docx/v1/documents/{document_id}/blocks/batch_update
错误码
| HTTP状态码 | 错误码 | 描述 | 排查建议 |
|---|---|---|---|
| 400 | 1770001 | invalid param | 确认传入的参数是否合法 |
| 404 | 1770002 | not found | 确认文档是否已被删除 |
| 400 | 1770003 | resource deleted | 确认资源是否已被删除 |
| 400 | 1770004 | too many blocks in document | 确认文档 Block 数量是否超上限 |
| 400 | 1770005 | too deep level in document | 确认文档 Block 层级是否超上限 |
| 400 | 1770006 | schema mismatch | 确认文档结构是否合法 |
| 400 | 1770007 | too many children in block | 确认指定 Block 的 Children 数量是否超上限 |
| 400 | 1770008 | too big file size | 确认上传的文件尺寸是否超上限 |
| 400 | 1770010 | too many table column | 确认表格列数是 否超上限 |
| 400 | 1770011 | too many table cell | 确认表格单元格数量是否超上限 |
| 400 | 1770012 | too many grid column | 确认 Grid 列数量是否超上限 |
| 400 | 1770013 | relation mismatch | 确认图片、文件等资源的关联关系是否正确，插入图片、文件需先上传素材 |
| 400 | 1770014 | parent children relation mismatch | 确认 Block 父子关系是否正确 |
| 400 | 1770015 | single edit with multi document | 确认 Block 所属文档与指定的 Document 是否相同 |
| 400 | 1770019 | repeated blockID in document | 确认 Document 中的 BlockID 是否有重复 |
| 400 | 1770020 | operation denied on copying document | 确认 Document 是否正在创建副本中 |
| 400 | 1770021 | too old document | 确认指定的 Document 版本过旧 |
| 400 | 1770022 | invalid page token | 确认 DocumentID 是否合法 |
| 400 | 1770024 | invalid operation | 确认操作是否合法 |
| 400 | 1770025 | operation and block not match | 确认指定 Block 应用对应操作是否合法 |
| 400 | 1770026 | row operation over range | 确认行操作下标是否越界 |
| 400 | 1770027 | column operation over range | 确认列操作下标是否越界 |
| 400 | 1770028 | block not support create children | 确认指定 Block 添加 Children 是否合法 |
| 400 | 1770029 | block not support to create | 确认指定 Block 是否支持创建 |
| 400 | 1770030 | invalid parent children relation | 确认指定操作其父子关系是否合法 |
| 400 | 1770031 | block not support to delete children | 确认指定 Block 是否支持删除 Children |
| 400 | 1770033 | raw content size exceed limited | 纯文本内容大小超过限制 |
| 400 | 1770034 | operation count exceed limited | 当前请求中涉及单元格个数过多，请拆分成多次请求 |
| 400 | 1770035 | resource count exceed limit | 当前请求中资源的数目超限，请拆分成多次请求。各类资源上限为：ChatCard 200 张，File 200 个，MentionDoc 200 个，MentionUser 200 个，Image 20 张，ISV 20 个，Sheet 5 篇，Bitable 5 篇。 |
| 400 | 1770038 | resource not found | 未查询到插入的资源或资源无权限插入，请检查资源标识是否正确。 |
| 403 | 1770032 | forbidden | 确认是否拥有合法权限 |
| 500 | 1771001 | server internal error | 服务器内部错误 |
| 500 | 1771006 | mount folder failed | 挂载文档到云空间目录失败 |
| 500 | 1771002 | gateway server internal error | 网关服务内部错误 |
| 500 | 1771003 | gateway marshal error | 网关服务解析错误 |
| 500 | 1771004 | gateway unmarshal error | 网关服务反解析错误 |
| 503 | 1771005 | system under maintenance | 系统服务正在维护中 |
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request PATCH 'https://open.feishu.cn/open-apis/docx/v1/documents/doxcnePuYufKa49ISjhD8Ih0ikh/blocks/batch_update' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
"requests": [
{
"block_id": "doxcnk0i44OMOaouw8AdXuXrp6b",
"merge_table_cells": {
"column_end_index": 2,
"column_start_index": 0,
"row_end_index": 1,
"row_start_index": 0
}
},
{
"block_id": "doxcn0K8iGSMW4Mqgs9qlyTP50d",
"update_text_elements": {
"elements": [
{
"text_run": {
"content": "Hello",
"text_element_style": {
"background_color": 2,
"bold": true,
"italic": true,
"strikethrough": true,
"text_color": 2,
"underline": true
}
}
},
{
"text_run": {
"content": "World ",
"text_element_style": {
"italic": true
}
}
},
{
"mention_doc": {
"obj_type": 22,
"token": "doxcnAJ9VRRJqVMYZ1MyKnayXWe",
"url": "https%3A%2F%2Ftest.feishu.cn%2Fdocx%2FdoxcnAJ9VRRJqVMYZ1MyKnayXWe"
}
}
]
}
}
]
}'响应示例响应示例
{
"code": 0,
"data": {
"blocks": [
{
"block_id": "doxcn0K8iGSMW4Mqgs9qlyTP50d",
"block_type": 2,
"parent_id": "doxcnAJ9VRRJqVMYZ1MyKnayXWe",
"text": {
"elements": [
{
"text_run": {
"content": "Hello",
"text_element_style": {
"background_color": 2,
"bold": true,
"inline_code": false,
"italic": true,
"strikethrough": true,
"text_color": 2,
"underline": true
}
}
},
{
"text_run": {
"content": "World ",
"text_element_style": {
"bold": false,
"inline_code": false,
"italic": true,
"strikethrough": false,
"underline": false
}
}
},
{
"mention_doc": {
"obj_type": 22,
"title": "Demo",
"token": "doxcnAJ9VRRJqVMYZ1MyKnayXWe",
"url": "https%3A%2F%2Ftest.feishu.cn%2Fdocx%2FdoxcnAJ9VRRJqVMYZ1MyKnayXWe"
}
}
],
"style": {
"done": false,
"folded": false,
"wrap": false
}
}
},
{
"block_id": "doxcnk0i44OMOaouw8AdXuXrp6b",
"block_type": 31,
"children": [
"doxcnO2UeYco4mu80sr6oRCiRpf",
"doxcnaAGMYMk6kcGeYXNfc1Rluc",
"doxcnCKuqMQOM0gAOYfysUgZD2d",
"doxcnMKg8Uk8wiAMIW8omQ06uoc"
],
"parent_id": "doxcnAJ9VRRJqVMYZ1MyKnayXWe",
"table": {
"cells": [
"doxcnO2UeYco4mu80sr6oRCiRpf",
"doxcnaAGMYMk6kcGeYXNfc1Rluc",
"doxcnCKuqMQOM0gAOYfysUgZD2d",
"doxcnMKg8Uk8wiAMIW8omQ06uoc"
],
"property": {
"column_size": 2,
"column_width": [
100,
100
],
"merge_info": [
{
"col_span": 2,
"row_span": 1
},
{
"col_span": 1,
"row_span": 1
},
{
"col_span": 1,
"row_span": 1
},
{
"col_span": 1,
"row_span": 1
}
],
"row_size": 2
}
}
}
],
"client_token": "e472907a-9ddc-4453-af28-22a6530b76b9",
"document_revision_id": 387
},
"msg": ""
}请求参数
Path 参数
document_id
string
文档的唯一标识
示例值:
doxcnePuYufKa49ISjhD8Ih0ikh
Query 参数
document_revision_id
string
可选
client_token
string
可选
示例值:
0e2633a3-aa1a-4171-af9e-0768ff863566
user_id_type
string
可选
Header 参数
Authorization
string
必需
默认值:
Bearer {{access_token}}
Content-Type
string
必需
默认值:
application/json; charset=utf-8
Body 参数application/json
返回响应
扫码加入交流群修改于 2023-01-13 09:29:01