更新字段
在多维表格数据表中更新一个字段。更新字段时为全量更新,property 等字段会被完全覆盖。
前提条件
调用此接口前,请确保当前调用身份(tenant_access_token 或 user_access_token)已有多维表格的编辑等文档权限,否则接口将返回 HTTP 403 或 400 状态码。了解更多,参考如何为应用或用户开通文档权限。
请求
| 项目 | 值 |
|---|---|
| HTTP URL | https://open.feishu.cn/open-apis/bitable/v1/apps/:app_token/tables/:table_id/fields/:field_id |
| HTTP Method | PUT |
| 接口频率限制 | 10 次/秒 |
| 支持的应用类型 | custom,isv |
| 权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用 开启任一权限即可 | base:field:update 更新字段 bitable:app 查看、评论、编辑和管理多维表格 |
请求头
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| Authorization | string | 是 | tenant_access_token 或 user_access_token 值格式:"Bearer access_token" 示例值:"Bearer u-7f1bcd13fc57d46bac21793a18e560" 了解更多:如何选择与获取 access token |
| Content-Type | string | 是 | 固定值:"application/json; charset=utf-8" |
路径参数
| 名称 | 类型 | 描述 |
|---|---|---|
app_token | string | 多维表格 App 的唯一标识。不同形态的多维表格,其 app_token 的获取方式不同: - 如果多维表格的 URL 以 ==feishu.cn/base== 开头,该多维表格的 app_token 是下图高亮部分: ![]() - 如果多维表格的 URL 以 ==feishu.cn/wiki== 开头,你需调用知识库相关获取知识空间节点信息接口获取多维表格的 app_token。当 obj_type 的值为 bitable 时,obj_token 字段的值才是多维表格的 app_token。了解更多,参考多维表格 app_token 获取方式。 示例值:"appbcbWCzen6D8dezhoCH2RpMAh" |
table_id | string | 多维表格数据表的唯一标识。获取方式: - 你可通过多维表格 URL 获取 table_id,下图高亮部分即为当前数据表的 table_id - 也可通过列出数据表接口获取 table_id![]() 示例值:"tblsRc9GRRXKqhvW" |
field_id | string | 数据表中一个字段的唯一标识。通过列出字段接口获取。 示例值:"fldPTb0U2y" |
请求体
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
field_name | string | 是 | 多维表格字段名称。名称中的首尾空格将会被去除。 示例值:"任务名称" |
type | int | 是 | 要更新的字段的类型。不支持更新 19 查找引用字段类型。 示例值:1 可选值有: - 1: 文本 - 2: 数字 - 3: 单选 - 4: 多选 - 5: 日期 - 7: 复选框 - 11: 人员 - 13: 电话号码 - 15: 超链接 - 17: 附件 - 18: 单项关联 - 20: 公式(不支持设置公式表达式) - 21: 双向关联 - 22: 地理位置 - 23: 群组 - 1001: 创建时间 - 1002: 最后更新时间 - 1003: 创建人 - 1004: 修改人 - 1005: 自动编号 |
property | app.table.field.property | 否 | 字段属性,了解如何填写字段,参考字段编辑指南。 |
└ options | app.table.field.property.option\[\] | 否 | 单选、多选字段的选项信息 |
└ name | string | 否 | 选项名称 示例值:"红色" |
└ id | string | 否 | 选项 ID 示例值:"optKl35lnG" |
└ color | int | 否 | 选项颜色,详情参考字段编辑指南。 示例值:0 数据校验规则: - 取值范围: 0 ~ 54 |
└ formatter | string | 否 | 数字、公式字段的显示格式。详情参考字段编辑指南。 示例值:"0" |
└ date_formatter | string | 否 | 日期、创建时间、最后更新时间字段的显示格式。详情参考字段编辑指南。 示例值:"yyyy/MM/dd HH:mm" |
└ auto_fill | boolean | 否 | 日期字段中新纪录自动填写创建时间 示例值:false |
└ multiple | boolean | 否 | 人员字段中允许添加多个成员,单向关联、双向关联中允许添加多个记录 示例值:false |
└ table_id | string | 否 | 单向关联、双向关联字段中关联的数据表的 ID 示例值:"tblsRc9GRRXKqhvW" |
└ table_name | string | 否 | 单向关联、双向关联字段中关联的数据表的名称 示例值:"table2" |
└ back_field_name | string | 否 | 双向关联字段中,关联的数据表中对应的双向关联字段名称 示例值:"table1-双向关联" |
└ auto_serial | app.field.property.auto_serial | 否 | 自动编号类型 |
└ type | string | 是 | 自动编号类型 示例值:"auto_increment_number" 可选值有: - custom: 自定义编号 - auto_increment_number: 自增数字 |
└ options | app.field.property.auto_serial.options\[\] | 否 | 自动编号规则列表 |
└ type | string | 是 | 自动编号的可选规则项类型 示例值:"created_time" 可选值有: - system_number: 自增数字位,value 范围为 1-9 - fixed_text: 固定字符,最大长度:20 - created_time: 创建时间,支持格式 "yyyyMMdd"、"yyyyMM"、"yyyy"、"MMdd"、"MM"、"dd" |
└ value | string | 是 | 与自动编号的可选规则项类型相对应的取值 示例值:"yyyyMMdd" |
└ location | app.field.property.location | 否 | 地理位置输入方式 |
└ input_type | string | 是 | 地理位置输入限制 示例值:"not_limit" 可选值有: - only_mobile: 只允许移动端上传 - not_limit: 无限制 |
└ formula_expression | string | 否 | 公式字段的表达式 示例值:"bitable::$table[tblNj92WQBAasdEf].$field[fldMV60rYs]*2" |
└ allowed_edit_modes | allowed_edit_modes | 否 | 字段支持的编辑模式 |
└ manual | boolean | 否 | 是否允许手动录入 示例值:true |
└ scan | boolean | 否 | 是否允许移动端录入 示例值:true |
└ min | number(float) | 否 | 进度、评分等字段的数据范围最小值 示例值:0 |
└ max | number(float) | 否 | 进度、评分等字段的数据范围最大值 示例值:10 |
└ range_customize | boolean | 否 | 进度等字段是否支持自定义范围 示例值:true |
└ currency_code | string | 否 | 货币币种 示例值:"CNY" |
└ rating | rating | 否 | 评分字段的相关设置 |
└ symbol | string | 否 | 评分字段的符号展示 示例值:"star" |
└ type | app.table.field.property.type | 否 | 设置公式字段的数据类型 注意:非所有多维表格都支持该能力。请参考获取多维表格元数据接口返回的formula_type 判断,当 formula_type 等于 2 时,表示需要设置该字段。 |
└ data_type | int | 是 | 公式字段对应的数据类型 示例值:1 可选值有: - 1: 多行文本(默认值)、条码 - 2: 数字(默认值)、进度、货币、评分 - 3: 单选 - 4: 多选 - 5: 日期 - 7: 复选框 - 11: 人员 - 13: 电话号码 - 15: 超链接 - 17: 附件 - 18: 单向关联 - 20: 公式 - 21: 双向关联 - 22: 地理位置 - 23: 群组 - 1001: 创建时间 - 1002: 最后更新时间 - 1003: 创建人 - 1004: 修改人 - 1005: 自动编号 |
└ ui_property | app.table.field.property.type.ui_property | 否 | 公式数据属性 |
└ currency_code | string | 否 | 货币币种 示例值:"CNY" 数据校验规则: - 长度范围: 0 ~ 20 字符 |
└ formatter | string | 否 | 数字、公式字段的显示格式 示例值:"0" 数据校验规则: - 长度范围: 0 ~ 50 字符 |
└ range_customize | boolean | 否 | 进度等字段是否支持自定义范围 示例值:true |
└ min | number(float) | 否 | 进度、评分等字段的数据范围最小值 示例值:1 数据校验规则: - 取值范围: 0 ~ 1 |
└ max | number(float) | 否 | 进度、评分等字段的数据范围最大值 示例值:100 数据校验规则: - 取值范围: 1 ~ 100 |
└ date_formatter | string | 否 | 日期、创建时间、最后更新时间字段的显示格式 示例值:"yyyy/MM/dd" 数据校验规则: - 长度范围: 0 ~ 50 字符 |
└ rating | rating | 否 | 评分字段的相关设置 |
└ symbol | string | 否 | 评分字段的符号展示 示例值:"star" |
└ ui_type | string | 否 | 公式字段在界面上的展示类型,例如进度字段是数字的一种展示形态 示例值:"Progress" 可选值有: - Number: 数字 - Progress: 进度 - Currency: 货币 - Rating: 评分 - DateTime: 日期 |
description | app.table.field.description | 否 | 字段的描述 |
└ disable_sync | boolean | 否 | 是否禁止同步该描述,只在新增、修改字段时生效。枚举值: - true:表示禁止同步该描述内容到表单的问题描述 - false:允许同步该描述 示例值:true 默认值: true |
└ text | string | 否 | 字段描述内容 示例值:"这是一个字段描述" |
ui_type | string | 否 | 字段在界面上的展示类型,例如进度字段是数字的一种展示形态 示例值:"Progress" 可选值有: - Text: 文本 - Email: 邮箱地址 - Barcode: 条码 - Number: 数字 - Progress: 进度 - Currency: 货币 - Rating: 评分 - SingleSelect: 单选 - MultiSelect: 多选 - DateTime: 日期 - Checkbox: 复选框 - User: 人员 - GroupChat: 群组 - Phone: 电话号码 - Url: 超链接 - Attachment: 附件 - SingleLink: 单向关联 - Formula: 公式 - DuplexLink: 双向关联 - Location: 地理位置 - CreatedTime: 创建时间 - ModifiedTime: 最后更新时间 - CreatedUser: 创建人 - ModifiedUser: 修改人 - AutoNumber: 自动编号 |
请求体示例
json
{
"field_name": "人员",
"type": 11,
"property": {
"multiple": true
}
}响应
响应体
| 名称 | 类型 | 描述 |
|---|---|---|
code | int | 错误码,非 0 表示失败 |
msg | string | 错误描述 |
data | \- | - |
└ field | app.table.field | 字段 |
└ field_name | string | 多维表格字段名称。名称中的首尾空格将会被去除。 |
└ type | int | 多维表格字段类型 可选值有: - 1: 文本 - 2: 数字 - 3: 单选 - 4: 多选 - 5: 日期 - 7: 复选框 - 11: 人员 - 13: 电话号码 - 15: 超链接 - 17: 附件 - 18: 关联 - 20: 公式 - 21: 双向关联 - 22: 地理位置 - 23: 群组 - 1001: 创建时间 - 1002: 最后更新时间 - 1003: 创建人 - 1004: 修改人 - 1005: 自动编号 |
└ property | app.table.field.property | 字段属性,具体参考:字段编辑指南 |
└ options | app.table.field.property.option\[\] | 单选、多选字段的选项信息 |
└ name | string | 选项名 |
└ id | string | 选项 ID,创建时不允许指定 ID |
└ color | int | 选项颜色 |
└ formatter | string | 数字、公式字段的显示格式 |
└ date_formatter | string | 日期、创建时间、最后更新时间字段的显示格式 |
└ auto_fill | boolean | 日期字段中新纪录自动填写创建时间 |
└ multiple | boolean | 人员字段中允许添加多个成员,单向关联、双向关联中允许添加多个记录 |
└ table_id | string | 单向关联、双向关联字段中关联的数据表的 ID |
└ table_name | string | 单向关联、双向关联字段中关联的数据表的名称 |
└ back_field_name | string | 双向关联字段中关联的数据表中对应的双向关联字段的名称 |
└ auto_serial | app.field.property.auto_serial | 自动编号类型 |
└ type | string | 自动编号类型 可选值有: - custom: 自定义编号 - auto_increment_number: 自增数字 |
└ options | app.field.property.auto_serial.options\[\] | 自动编号规则列表 |
└ type | string | 自动编号的可选规则项类型 可选值有: - system_number: 自增数字位,value范围1-9 - fixed_text: 固定字符,最大长度:20 - created_time: 创建时间,支持格式 "yyyyMMdd"、"yyyyMM"、"yyyy"、"MMdd"、"MM"、"dd" |
└ value | string | 与自动编号的可选规则项类型相对应的取值 |
└ location | app.field.property.location | 地理位置输入方式 |
└ input_type | string | 地理位置输入限制 可选值有: - only_mobile: 只允许移动端上传 - not_limit: 无限制 |
└ formula_expression | string | 公式字段的表达式 |
└ allowed_edit_modes | allowed_edit_modes | 字段支持的编辑模式 |
└ manual | boolean | 是否允许手动录入 |
└ scan | boolean | 是否允许移动端录入 |
└ min | number(float) | 进度、评分等字段的数据范围最小值 |
└ max | number(float) | 进度、评分等字段的数据范围最大值 |
└ range_customize | boolean | 进度等字段是否支持自定义范围 |
└ currency_code | string | 货币币种 |
└ rating | rating | 评分字段的相关设置 |
└ symbol | string | 评分字段的符号展示 |
└ type | app.table.field.property.type | 设置公式字段的数据类型 非所有文档都支持该能力,参考获取多维表格元数据接口返回的formula_type信息。formula_typ等于2表示需要设置该字段。 |
└ data_type | int | 公式字段对应的数据类型 可选值有: - 1: 多行文本(默认值)、条码 - 2: 数字(默认值)、进度、货币、评分 - 3: 单选 - 4: 多选 - 5: 日期 - 7: 复选框 - 11: 人员 - 13: 电话号码 - 15: 超链接 - 17: 附件 - 18: 单向关联 - 20: 公式 - 21: 双向关联 - 22: 地理位置 - 23: 群组 - 1001: 创建时间 - 1002: 最后更新时间 - 1003: 创建人 - 1004: 修改人 - 1005: 自动编号 |
└ ui_property | app.table.field.property.type.ui_property | 公式数据属性 |
└ currency_code | string | 货币币种 |
└ formatter | string | 数字、公式字段的显示格式 |
└ range_customize | boolean | 进度等字段是否支持自定义范围 |
└ min | number(float) | 进度、评分等字段的数据范围最小值 |
└ max | number(float) | 进度、评分等字段的数据范围最大值 |
└ date_formatter | string | 日期、创建时间、最后更新时间字段的显示格式 |
└ rating | rating | 评分字段的相关设置 |
└ symbol | string | 评分字段的符号展示 |
└ ui_type | string | 公式字段在界面上的展示类型,例如进度字段是数字的一种展示形态 可选值有: - Number: 数字 - Progress: 进度 - Currency: 货币 - Rating: 评分 - DateTime: 日期 |
└ description | app.table.field.description | 字段的描述 |
└ disable_sync | boolean | 是否禁止同步,如果为true,表示禁止同步该描述内容到表单的问题描述(只在新增、修改字段时生效) |
└ text | string | 字段描述内容 |
└ is_primary | boolean | 是否是索引列 |
└ field_id | string | 多维表格字段 ID |
└ ui_type | string | 字段在界面上的展示类型,例如进度字段是数字的一种展示形态 可选值有: - Text: 文本 - Email: 邮箱地址 - Barcode: 条码 - Number: 数字 - Progress: 进度 - Currency: 货币 - Rating: 评分 - SingleSelect: 单选 - MultiSelect: 多选 - DateTime: 日期 - Checkbox: 复选框 - User: 人员 - GroupChat: 群组 - Phone: 电话号码 - Url: 超链接 - Attachment: 附件 - SingleLink: 单向关联 - Formula: 公式 - DuplexLink: 双向关联 - Location: 地理位置 - CreatedTime: 创建时间 - ModifiedTime: 最后更新时间 - CreatedUser: 创建人 - ModifiedUser: 修改人 - AutoNumber: 自动编号 |
└ is_hidden | boolean | 是否是隐藏字段 |
响应体示例
json
{
"code": 0,
"data": {
"field": {
"field_id": "fldEPIQAXw",
"field_name": "人员",
"is_primary": false,
"property": {
"multiple": true
},
"type": 11
}
},
"msg": "success"
}错误码
| HTTP状态码 | 错误码 | 描述 | 排查建议 |
|---|---|---|---|
| 200 | 1254000 | WrongRequestJson | 请求体错误 |
| 200 | 1254001 | WrongRequestBody | 请求体错误 |
| 200 | 1254002 | Fail | 导致报 1254002 错误码的场景较多,请参考以下建议排查: - 如果单次操作的内容变更较大,请尝试在单次操作中减少数据量 - 如果你并发调用了接口,请尝试控制请求间隔,稍后重试 - 如果在知识库(wiki)中创建多维表格,请检查你是否使用了知识库创建知识空间节点接口创建多维表格。在此场景下不能使用创建多维表格接口 - 请检查接口参数是否有误。例如,在分页查询多维表格时,传递了无效的 page_token,或传递了错误的数据表的 table_id - 如果该报错偶尔发生,可能是服务器超时或不稳定,请重试解决 |
| 200 | 1254003 | WrongBaseToken | app_token 错误。app_token 是多维表格 App 的唯一标识。不同形态的多维表格,其 app_token 的获取方式不同: - 如果多维表格的 URL 以 ==feishu.cn/base== 开头,该多维表格的 app_token 是下图高亮部分: - 如果多维表格的 URL 以 ==feishu.cn/wiki== 开头,你需调用知识库相关获取知识空间节点信息接口获取多维表格的 app_token。当 obj_type 的值为 bitable 时,obj_token 字段的值才是多维表格的 app_token。 了解更多,参考多维表格 app_token 获取方式。 |
| 200 | 1254004 | WrongTableId | table_id 错误。table_id 是多维表格数据表的唯一标识。获取方式: - 你可通过多维表格 URL 获取 table_id,下图高亮部分即为当前数据表的 table_id - 也可通过列出数据表接口获取 table_id ![]() |
| 200 | 1254005 | WrongViewId | view_id 错误。view_id 是多维表格中视图的唯一标识。获取方式: - 在多维表格的 URL 地址栏中,view_id 是下图中高亮部分: - 通过列出视图接口获取。暂时无法获取到嵌入到云文档中的多维表格的 view_id。 注意: 当 filter 参数 或 sort 参数不为空时,请求视为对数据表中的全部数据做条件过滤,指定的 view_id 会被忽略。 |
| 200 | 1254006 | WrongRecordId | record_id 错误。record_id 是数据表中一条记录的唯一标识。通过查询记录接口获取 |
| 200 | 1254007 | EmptyValue | 空值 |
| 200 | 1254008 | EmptyView | 空视图 |
| 200 | 1254009 | WrongFieldId | field_id 错误。field_id 是数据表中一个字段的唯一标识。通过列出字段接口获取 |
| 200 | 1254010 | ReqConvError | 请求错误 |
| 200 | 1254012 | NotSupportFieldOrView | 不支持的字段或视图。注意数据表的初始索引字段仅支持以下类型: - 1:文本 - 2:数字 - 5:日期 - 13:电话号码 - 15:超链接 - 20:公式 - 22:地理位置 |
| 200 | 1254013 | TableNameDuplicated | 表名重复 |
| 200 | 1254014 | FieldNameDuplicated | 字段名重复 |
| 200 | 1254015 | FieldTypeValueNotMatch | 字段类型和值不匹配 |
| 200 | 1254026 | EmptyOptionName | 选项名不能为空 |
| 400 | 1254028 | EmptyFieldName | 字段名为空 |
| 400 | 1254029 | InvalidFieldName | 字段名无效 |
| 200 | 1254030 | TooLargeResponse | 响应体过大 |
| 400 | 1254036 | Base is copying, please try again later. | 多维表格副本复制中,稍后重试 |
| 200 | 1254040 | BaseTokenNotFound | app_token 不存在。app_token 是多维表格 App 的唯一标识。不同形态的多维表格,其 app_token 的获取方式不同: - 如果多维表格的 URL 以 ==feishu.cn/base== 开头,该多维表格的 app_token 是下图高亮部分: - 如果多维表格的 URL 以 ==feishu.cn/wiki== 开头,你需调用知识库相关获取知识空间节点信息接口获取多维表格的 app_token。当 obj_type 的值为 bitable 时,obj_token 字段的值才是多维表格的 app_token。 了解更多,参考多维表格 app_token 获取方式。 |
| 200 | 1254041 | TableIdNotFound | table_id 不存在。table_id 是多维表格数据表的唯一标识。获取方式: - 你可通过多维表格 URL 获取 table_id,下图高亮部分即为当前数据表的 table_id - 也可通过列出数据表接口获取 table_id ![]() |
| 200 | 1254042 | ViewIdNotFound | view_id 不存在。view_id 是多维表格中视图的唯一标识。获取方式: - 在多维表格的 URL 地址栏中,view_id 是下图中高亮部分: - 通过列出视图接口获取。暂时无法获取到嵌入到云文档中的多维表格的 view_id。 注意: 当 filter 参数 或 sort 参数不为空时,请求视为对数据表中的全部数据做条件过滤,指定的 view_id 会被忽略。 |
| 200 | 1254043 | RecordIdNotFound | record_id 不存在。record_id 是数据表中一条记录的唯一标识。通过查询记录接口获取 |
| 200 | 1254044 | FieldIdNotFound | field_id 不存在。field_id 是数据表中一个字段的唯一标识。通过列出字段接口获取 |
| 200 | 1254060 | TextFieldConvFail | 文本字段错误 |
| 200 | 1254061 | NumberFieldConvFail | 数字字段错误 |
| 200 | 1254062 | SingleSelectFieldConvFail | 单选字段错误 |
| 200 | 1254063 | MultiSelectFieldConvFail | 多选字段错误 |
| 200 | 1254064 | DatetimeFieldConvFail | 日期字段错误 |
| 200 | 1254065 | CheckboxFieldConvFail | 复选框字段错误 |
| 200 | 1254066 | UserFieldConvFail | 人员字段有误。原因可能是: - user_id_type 参数指定的 ID 类型与传入的 ID 类型不匹配 - 传入了不识别的类型或结构,目前只支持填写 id 参数,且需要传入数组 - 跨应用传入了 open_id。如果跨应用传入 ID,建议使用 user_id。不同应用获取的 open_id 不能交叉使用 - 若想对人员字段传空,可传 null |
| 200 | 1254067 | LinkFieldConvFail | 关联字段错误 |
| 200 | 1254070 | ActionValidateFailed | Action验证失败 |
| 400 | 1254080 | TextFieldPropertyError | 文本字段property错误。请参考字段编辑指南-字段的属性 property查看字段的 property 结构。 |
| 400 | 1254081 | NumberFieldPropertyError | 数字字段property错误。请参考字段编辑指南-字段的属性 property查看字段的 property 结构。 |
| 400 | 1254082 | SingleSelectFieldPropertyError | 单选字段property错误。请参考字段编辑指南-字段的属性 property查看字段的 property 结构。 |
| 400 | 1254083 | MultiSelectFieldPropertyError | 多选字段property错误。请参考字段编辑指南-字段的属性 property查看字段的 property 结构。 |
| 400 | 1254084 | DateFieldPropertyError | 日期字段property错误。请参考字段编辑指南-字段的属性 property查看字段的 property 结构。 |
| 400 | 1254085 | CheckboxFieldPropertyError | 复选框字段property错误。请参考字段编辑指南-字段的属性 property查看字段的 property 结构。 |
| 400 | 1254086 | UserFieldPropertyError | 人员字段property错误。请参考字段编辑指南-字段的属性 property查看字段的 property 结构。 |
| 400 | 1254087 | URLFieldPropertyError | 超链接字段property错误。请参考字段编辑指南-字段的属性 property查看字段的 property 结构。 |
| 400 | 1254088 | AttachFieldPropertyError | 附件字段property错误。请参考字段编辑指南-字段的属性 property查看字段的 property 结构。 |
| 400 | 1254089 | LinkFieldPropertyError | 单向关联字段property错误。请参考字段编辑指南-字段的属性 property查看字段的 property 结构。 |
| 400 | 1254090 | LookUpFieldPropertyError | 查找引用字段property错误。请参考字段编辑指南-字段的属性 property查看字段的 property 结构。 |
| 400 | 1254091 | FormulaFieldPropertyError | 公式字段property错误。请参考字段编辑指南-字段的属性 property查看字段的 property 结构。 |
| 400 | 1254092 | DuplexLinkFieldPropertyError | 双向关联字段property错误。请参考字段编辑指南-字段的属性 property查看字段的 property 结构。 |
| 400 | 1254093 | CreatedTimeFieldPropertyError | 创建时间字段property错误。请参考字段编辑指南-字段的属性 property查看字段的 property 结构。 |
| 400 | 1254094 | ModifiedTimeFieldPropertyError | 最后更新时间字段property错误。请参考字段编辑指南-字段的属性 property查看字段的 property 结构。 |
| 400 | 1254095 | CreatedUserFieldPropertyError | 创建人字段property错误。请参考字段编辑指南-字段的属性 property查看字段的 property 结构。 |
| 400 | 1254096 | ModifiedUserFieldPropertyError | 修改人字段property错误。请参考字段编辑指南-字段的属性 property查看字段的 property 结构。 |
| 200 | 1254100 | TableExceedLimit | 数据表或仪表盘数量超限。每个多维表格中,数据表加仪表盘的数量最多为 100 个 |
| 200 | 1254101 | ViewExceedLimit | 视图数量超限, 限制200个 |
| 200 | 1254102 | FileExceedLimit | 文件数量超限 |
| 200 | 1254103 | RecordExceedLimit | 记录数量超限, 限制20,000条 |
| 200 | 1254104 | RecordAddOnceExceedLimit | 单次添加记录数量超限, 单次调用最多更新 1,000 条记录 |
| 200 | 1254105 | ColumnExceedLimit | 字段数量超限 |
| 200 | 1254130 | TooLargeCell | 格子内容过大 |
| 200 | 1254290 | TooManyRequest | 请求过快,稍后重试 |
| 200 | 1254291 | Write conflict | 在同一个数据表中,并发调用了读写接口或请求过快,出现冲突。请参考以下建议解决: - 确保没有并发调用多维表格读写相关接口 - 若操作量较大,建议在接口与接口之间增加 0.5 或 1 秒的延迟,也可在报错中增加重试逻辑,确保业务的稳定性 - 对于写接口,可以将接口中的查询参数 ignore_consistency_check 设置为 true,表示在读写操作时,暂时忽略一致性检查,以提高性能 |
| 200 | 1254301 | OperationTypeError | 多维表格未开启高级权限或不支持开启高级权限 |
| 200 | 1254606 | DataNotChange | 数据无变更 |
| 200 | 1255001 | InternalError | 内部错误,请联系技术支持 |
| 200 | 1255002 | RpcError | 内部错误,请联系技术支持 |
| 200 | 1255003 | MarshalError | 序列化错误,请联系技术支持 |
| 200 | 1255004 | UmMarshalError | 反序列化错误,请联系技术支持 |
| 200 | 1255005 | ConvError | 内部错误,请联系技术支持 |
| 504 | 1255040 | Request timed out, please try again later | 请求超时,进行重试 |
| 400 | 1254607 | Data not ready, please try again later | 该报错一般是由于前置操作未执行完成,或本次操作数据太大,服务器计算超时导致。遇到该错误码时,建议等待一段时间后重试。通常有以下几种原因: - 编辑操作频繁:开发者对多维表格的编辑操作非常频繁。可能会导致由于等待前置操作处理完成耗时过长而超时的情况。多维表格底层对数据表的处理基于版本维度的串行方式,不支持并发。因此,并发请求时容易出现此类错误,不建议开发者对单个数据表进行并发请求。 - 批量操作负载重:开发者在多维表格中进行批量新增、删除等操作时,如果数据表的数据量非常大,可能会导致单次请求耗时过长,最终导致请求超时。建议开发者适当降低批量请求的 page_size 以减少请求耗时。 - 资源分配与计算开销:资源分配是基于单文档维度的,如果读接口涉及公式计算、排序等计算逻辑,会占用较多资源。例如,并发读取一个文档下的多个数据表也可能导致该文档阻塞。 |
| 403 | 1254302 | Permission denied. | 调用身份缺少多维表格的高级权限。你需给予调用身份数据表的 可管理 权限或多维表格的 可管理 等权限,再重新调用。具体步骤如下所示: - 对用户授予高级权限,你可在 多维表格高级权限设置 中添加用户,为用户开通足够权限;或在多维表格页面右上方 分享 入口为当前用户添加可管理权限。详情参考飞书帮助中心文档使用多维表格高级权限。 - 对应用授予高级权限,你需通过多维表格页面右上方 「...」 -> 「...更多」 ->「添加文档应用」 入口为应用添加可管理权限。 注意: 在 添加文档应用 前,你需确保目标应用至少开通了一个多维表格的 API 权限。否则你将无法在文档应用窗口搜索到目标应用。 - 你也可以在 多维表格高级权限设置 中添加用户或一个包含应用的群组,给予这个群自定义的读写等权限。 |
| 403 | 1254304 | Permission denied. | 仅企业版和旗舰版飞书支持行列权限 |
| 403 | 1254608 | ReqRecommited | 基于同一个多维表格版本重复提交了更新请求(传入了相同的 client_token),常见于并发或时间间隔极短的请求,例如并发将一个视图的信息更新为相同的内容。建议稍后重试 |



- 通过
- 对应用授予高级权限,你需通过多维表格页面右上方 「...」 -> 「...更多」 ->「添加文档应用」 入口为应用添加可管理权限。
注意: 在 添加文档应用 前,你需确保目标应用至少开通了一个多维表格的