新增字段

在多维表格数据表中新增一个字段。

前提条件

调用此接口前，请确保当前调用身份（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
HTTP Method	POST
接口频率限制	10 次/秒
支持的应用类型	custom,isv
权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用 开启任一权限即可	base:field:create 新增字段 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"

查询参数

名称	类型	必填	描述
client_token	string	否	格式为标准的 uuidv4，操作的唯一标识，用于幂等的进行更新操作。此值为空表示将发起一次新的请求，此值非空表示幂等的进行更新操作。 示例值：fe599b60-450f-46ff-b2ef-9f6675625b97

请求体

名称	类型	必填	描述
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，创建字段时不允许指定 ID。 示例值："optKl35lnG"
└ color	int	否	选项颜色，详情参考字段编辑指南。 示例值：0 数据校验规则： - 取值范围：0 ～ 54
└ formatter	string	否	数字和公式字段的显示格式。详情参考字段编辑指南。 示例值："0"
└ date_formatter	string	否	日期、创建时间、最后更新时间字段的显示格式。默认为 "yyyy/MM/dd"。枚举值如下所示： - "yyyy/MM/dd"：2021/1/30 - "yyyy-MM-dd HH:mm"：2021/1/30 14:00 - "MM-dd"：1月30日 - "MM/dd/yyyy"：2021/1/30 - "dd/MM/yyyy"：2021/1/30" 示例值："yyyy/MM/dd"
└ auto_fill	boolean	否	对于新记录，是否自动填写创建时间。默认为 false。 示例值：false
└ multiple	boolean	否	人员字段中是否允许添加多个成员，或单向关联、双向关联字段中是否允许添加多个记录。默认为 true。 示例值：false
└ table_id	string	否	单向关联、双向关联字段中关联的数据表的 ID 示例值："tblsRc9GRRXKqhvW"
└ 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: 自增数字的位数 - fixed_text: 固定字符 - created_time: 创建时间
└ value	string	是	规则类型对应的值。 - 若规则类型为 "type": "system_number"，value 为范围在 1-9 的整数，表示自增数字的位数 - 若规则类型为 "type": "fixed_text"，value 为范围在 20 个字符以内的固定字符 - 若规则类型为 "type": "created_time"，value 用于指定日期的格式。可选值如下所示： - "yyyyMMdd"：日期为 20220130 的格式 - "yyyyMM"：日期为 202201 的格式 - "yyyy"：日期为 2022 的格式 - "MMdd"：日期为 130 的格式，表示 1 月 30 日 - "MM"：日期为 1 的格式，表示月份 - "dd"：日期为 30 的格式 示例值："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 示例值：true
└ scan	boolean	否	是否允许移动端录入。默认为 true 示例值：true
└ min	number(float)	否	进度和评分字段的数据范围最小值。不同字段类型中，该参数的必填属性和取值范围不同，详情参考字段编辑指南。 示例值：0
└ max	number(float)	否	进度和评分字段的数据范围最大值。不同字段类型中，该参数的必填属性和取值范围不同，详情参考字段编辑指南。 示例值：10
└ range_customize	boolean	否	进度字段是否允许自定义进度条值，默认为 false。 示例值：true
└ currency_code	string	否	货币的具体类型，枚举值如下所示： - CNY：人民币，货币符号为 ¥ - USD：美元，货币符号为 $ - EUR：欧元，货币符号为 € - GBP：英镑，货币符号为 £ - AED：阿联酋迪拉姆，货币符号为 dh - AUD：澳大利亚元，货币符号为 $ - BRL：巴西雷亚尔，货币符号为 R$ - CAD：加拿大元，货币符号为 $ - CHF：瑞士法郎，货币符号为 CHF - HKD：港元，货币符号为 $ - INR：印度卢比，货币符号为 ₹ - IDR：印尼盾，货币符号为 Rp - JPY：日元，货币符号为 ¥ - KRW：韩元，货币符号为 ₩ - MOP：澳门元，货币符号为 MOP$ - MXN：墨西哥比索，货币符号为 $ - MYR：马来西亚令吉，货币符号为 RM - PHP：菲律宾比索，货币符号为 ₱ - PLN：波兰兹罗提，货币符号为 zł - RUB：俄罗斯卢布，货币符号为 ₽ - SGD：新加坡元，货币符号为 $ - THB：泰国铢，货币符号为 ฿ - TRY：土耳其里拉，货币符号为 ₺ - TWD：新台币，货币符号为 NT$ - VND：越南盾，货币符号为 ₫ 示例值："CNY"
└ rating	rating	否	评分字段的相关设置
└ symbol	string	否	评分的图标，默认为 "star"。枚举值如下所示： - star：星星 - heart：爱心 - thumbsup：赞 - fire：火 - smile：笑脸 - lightning：闪电 - flower：花 - number：数字 示例值："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: 自动编号

请求体示例

{
    "field_name":"文本",
    "type":1
}

响应

响应体

名称	类型	描述
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_type 等于 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	是否是隐藏字段

响应体示例

{
    "code": 0,
    "data": {
        "field": {
            "field_id": "fld4bocNLY",
            "field_name": "文本",
            "type": 1,
            "property": null
        }
    },
    "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.	复制多维表格为异步操作，该错误码表示当前多维表格仍在复制中，在复制期间无法操作当前多维表格。需要等待复制完成后再操作
400	1254037	Invalid client token, make sure that it complies with the specification.	幂等键格式错误，需要传入 uuidv4 格式
200	1254040	BaseTokenNotFound	app_token 不存在。不同形态的多维表格，其 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 不存在。获取方式： - 你可通过多维表格 URL 获取 table_id，下图高亮部分即为当前数据表的 table_id - 也可通过列出数据表接口获取 table_id
200	1254042	ViewIdNotFound	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	1255001	InternalError	内部错误，请联系技术支持
200	1255002	RpcError	内部错误，请联系技术支持
200	1255003	MarshalError	序列化错误，请联系技术支持
200	1255004	UmMarshalError	反序列化错误
200	1255005	ConvError	内部错误，请联系技术支持
400	1255006	Client token conflict, please generate a new client token and try again.	幂等键冲突，需要重新随机生成一个幂等键
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），常见于并发或时间间隔极短的请求，例如并发将一个视图的信息更新为相同的内容。建议稍后重试