# 更新自定义角色(新版)

更新多维表格高级权限中自定义的角色。
**注意事项**：相较于旧版接口，新版自定义角色接口支持高级权限 2.0 版本新增的权限点位，包括更精细的行级别权限控制、多维表格的复制、导出点位的控制等。
**注意事项**：更新自定义角色为增量更新，仅对传值的字段进行更新，不传值则不更新。

## 前提条件

要调用自定义角色相关接口，你需确保多维表格已开启高级权限。你可通过[更新多维表格元数据](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app/update)接口开启高级权限。

## 请求

基本 | &nbsp;
---|---
HTTP URL | https://open.feishu.cn/open-apis/base/v2/apps/:app_token/roles/:role_id
HTTP Method | PUT
接口频率限制 | [10 次/秒](https://open.feishu.cn/document/ukTMukTMukTM/uUzN04SN3QjL1cDN)
支持的应用类型 | Custom App、Store App
权限要求<br>**调用该 API 所需的权限。开启其中任意一项权限即可调用** | 更新自定义角色(base:role:update)

### 请求头

名称 | 类型 | 必填 | 描述
---|---|---|---
Authorization | string | 是 | `tenant_access_token`<br>或<br>`user_access_token`<br>**值格式**："Bearer `access_token`"<br>**示例值**："Bearer u-7f1bcd13fc57d46bac21793a18e560"<br>[了解更多：如何选择与获取 access token](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-choose-which-type-of-token-to-use)
Content-Type | string | 是 | **固定值**："application/json; charset=utf-8"

### 路径参数

名称 | 类型 | 描述
---|---|---
app_token | string | 多维表格 App 的唯一标识。不同形态的多维表格，其 `app_token` 的获取方式不同：<br>- 如果多维表格的 URL 以 ==**feishu.cn/base**== 开头，该多维表格的 `app_token` 是下图高亮部分：<br>![app_token.png](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/6916f8cfac4045ba6585b90e3afdfb0a_GxbfkJHZBa.png?height=766&lazyload=true&width=3004)<br>- 如果多维表格的 URL 以 ==**feishu.cn/wiki**== 开头，你需调用知识库相关[获取知识空间节点信息](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/wiki-v2/space/get_node)接口获取多维表格的 app_token。当 `obj_type` 的值为 `bitable` 时，`obj_token` 字段的值才是多维表格的 `app_token`。<br>了解更多，参考[多维表格 app_token 获取方式](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/bitable-overview#-752212c)。<br>**示例值**："appbcbWCzen6D8dezhoCH2RpMAh"<br>**数据校验规则**：<br>- 长度范围：`0` ～ `100` 字符
role_id | string | 多维表格高级权限中自定义角色的唯一标识，以 rol 开头。获取方式：通过[列出自定义角色](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-role/list)接口获取。<br>**示例值**："roljRpwIUt"<br>**数据校验规则**：<br>- 长度范围：`0` ～ `100` 字符

### 请求体

名称 | 类型 | 必填 | 描述
---|---|---|---
role_name | string | 是 | 自定义角色名称<br>**示例值**："自定义权限1"<br>**数据校验规则**：<br>- 长度范围：`0` ～ `100` 字符
table_roles | table_role\[\] | 是 | 针对数据表的权限设置，未设置该字段的情况下，保持旧值不变<br>**数据校验规则**：<br>- 长度范围：`0` ～ `100`
table_perm | int | 是 | 数据表权限。<br>**提示**：**协作者可编辑自己的记录** 和 **可编辑指定字段** 是 **可编辑记录** 的特殊情况，可通过指定 `rec_rule` 或 `field_perm` 参数实现相同的效果。<br>**示例值**：0<br>**可选值有**：<br>- 0：无权限<br>- 1：仅可阅读<br>- 2：可编辑<br>- 4：可管理<br>**数据校验规则**：<br>- 取值范围：`0` ～ `4`
table_name | string | 否 | 数据表名称<br>**示例值**："数据表1"<br>**数据校验规则**：<br>- 长度范围：`0` ～ `50` 字符
table_id | string | 否 | 多维表格数据表的唯一标识。获取方式：<br>- 你可通过多维表格 URL 获取 `table_id`，下图高亮部分即为当前数据表的 `table_id`<br>- 也可通过[列出数据表](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table/list)接口获取 `table_id`<br>![](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/18741fe2a0d3cafafaf9949b263bb57d_yD1wkOrSju.png?height=746&lazyload=true&maxWidth=700&width=2976)<br>**示例值**："tblKz5D60T4JlfcT"<br>**数据校验规则**：<br>- 长度范围：`0` ～ `50` 字符
rec_rule | rec_rule | 否 | 记录筛选条件，当 `table_perm` 为 1 或 2 时生效。用于指定可编辑或可阅读的记录。<br>- rec_rule字段未设置、且 `table_perm `不变的情况下，保持旧值。<br>- 字段 value 为 {} 的情况下，表示设置为默认值，即全部可编辑或可阅读，具体权限需结合 table_perm 参数。
conditions | rec_rule_condition\[\] | 否 | 记录筛选条件，用于指定可编辑或可阅读的记录。<br>**数据校验规则**：<br>- 长度范围：`0` ～ `10`
field_name | string | 是 | 条件字段的名称。记录筛选条件是“创建人包含访问者本人”时，此参数值为 ""。<br>**示例值**："单选"
operator | string | 否 | 条件运算符<br>**示例值**："is"<br>**可选值有**：<br>- is：等于<br>- isNot：不等于<br>- contains：包含<br>- doesNotContain：不包含<br>- isEmpty：为空<br>- isNotEmpty：不为空<br>**默认值**：`is`
value | string\[\] | 否 | 条件的值，可以是单个值或多个值的数组。详情参考[字段目标值（value）填写说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table-record/record-filter-guide#3e0fd644)。<br>**示例值**：["optbdVHf4q"]<br>**数据校验规则**：<br>- 长度范围：`0` ～ `50`
conjunction | string | 否 | 多个筛选条件的关系<br>**示例值**："and"<br>**可选值有**：<br>- and：与<br>- or：或<br>**默认值**：`and`
other_perm | int | 否 | 其他记录权限，仅在 `table_perm` 为 2 （数据表权限为可编辑）时生效。<br>- 当 `other_perm` 为 1 时，表示未命中 `rec_rule` 的记录仅可阅读，不可编辑<br>- 当 `other_perm` 为 0 时，表示既未命中 `rec_rule`、也未命中 `other_rec_rule` 的记录会被禁止阅读。即你可以通过 `other_rec_rule` 进一步指定可阅读的记录范围。<br>**示例值**：1<br>**可选值有**：<br>- 0：禁止查看<br>- 1：仅可阅读<br>**默认值**：`0`
other_rec_rule | other_rec_rule | 否 | 记录筛选条件，在 `table_perm` 为 2 且`rec_rule.other_perm` 为 0 时生效。<br>- 对于未命中 `rec_rule` 的记录，通过 `other_rec_rule` 指定可阅读记录范围；此时，既未命中 `rec_rule`、也未命中 `other_rec_rule` 的记录会被禁止阅读。<br>- `other_rec_rule` 字段未设置、且 `table_perm` 与 `rec_rule` 不变的情况下，将会保持旧值不变。<br>- `other_rec_rule` 字段设置为 {} 时，且 `table_perm` 与`rec_rule` 不变的情况下，表示设置为默认值，即非`rec_rule` 记录全部可阅读。<br>**注意**：仅高级权限为 v2 版本的多维表格支持该参数。是否是 v2 版本可调用[获取多维表格元数据<br>](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app/get)查看。
conditions | rec_rule_condition\[\] | 否 | 记录筛选条件，用于指定可阅读的记录。<br>**数据校验规则**：<br>- 长度范围：`0` ～ `10`
field_name | string | 是 | 条件字段的名称。记录筛选条件是“创建人包含访问者本人”时，此参数值为 ""。<br>**示例值**："单选"
operator | string | 否 | 条件运算符<br>**示例值**："is"<br>**可选值有**：<br>- is：等于<br>- isNot：不等于<br>- contains：包含<br>- doesNotContain：不包含<br>- isEmpty：为空<br>- isNotEmpty：不为空<br>**默认值**：`is`
value | string\[\] | 否 | 条件的值，可以是单个值或多个值的数组。详情参考[字段目标值（value）填写说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table-record/record-filter-guide#3e0fd644)。<br>**示例值**：["optbdVHf4q"]<br>**数据校验规则**：<br>- 长度范围：`0` ～ `50`
conjunction | string | 否 | 多个筛选条件的关系<br>**示例值**："and"<br>**可选值有**：<br>- and：与<br>- or：或<br>**默认值**：`and`
field_perm | map&lt;string, int&gt; | 否 | 字段权限，仅在 `table_perm` 为 1和 2 时生效。用于设置字段可编辑或可阅读。类型为 map，key 是字段名称，value 是字段权限。对于未设置的多维表格字段，则为无权限。更新时，`field_perm` 未传值时，将保留旧值不变。`field_perm` 传{}时，则将所有字段设置为默认值可编辑或者可阅读，默认值需结合`table_perm `字段。value 枚举值有：<br>- `1`：可阅读<br>- `2`：可添加<br>- `3`：可编辑<br>**示例值**：{"姓名": 1, "年龄": 2}
allow_add_record | boolean | 否 | 新增记录权限，仅在 `table_perm` 为 2 时生效，用于设置记录是否可以新增。<br>**示例值**：true<br>**默认值**：`true`
allow_delete_record | boolean | 否 | 删除记录权限，仅在 `table_perm` 为 2 时生效，用于设置记录是否可以删除。<br>**示例值**：true<br>**默认值**：`true`
view_perm | int | 否 | 设置视图的编辑权限。<br>**示例值**：2<br>**可选值有**：<br>- 1：可阅读<br>- 2：可编辑<br>**默认值**：`2`<br>**数据校验规则**：<br>- 取值范围：`0` ～ `2`
view_rules | map&lt;string, int&gt; | 否 | 可读的视图集合，仅在 `view_perm` 为 1 （视图为可阅读）时生效。更新时，未设置该字段`view_rules `，且 `view_perm` 未变化的情况下，将保留旧值。设置该字段`view_rules `为{}，且 `view_perm` 为1的情况下，会将所有视图置为可读。<br>该参数类型为 map，其中 key 是[视图 ID](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/bitable-overview#5b05b8ca)，value 是视图对应的权限。value 枚举值有：<br>- `0`：无权限<br>- `1`：可阅读<br>**注意**：仅高级权限为 v2 版本的多维表格支持该参数。是否是 v2 版本可调用[获取多维表格元数据<br>](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app/get)查看。<br>**示例值**：{"vewEYknYcC": 0}
field_action_rules | map&lt;string, map&lt;string, int&gt;&gt; | 否 | 更新字段的权限，仅可配置单多选字段、附件字段。可选的点位有：<br>-  `select_option_edit` : 选项配置点位，配置是否可增删改单、多选选项，未设置表示无权限。<br>- `attachment_export`: 附件操作权限点位，配置是否可导出附件，未设置表示可导出。<br>该参数类型为两层 map 结构，其中 key 是字段点位权限，value 是字段权限集合。字段权限集合也是一个 map 结构，其中 key 是字段名称，value 是字段点位权限：<br>- `0`：无权限<br>- `1`：有权限<br>**注意**：仅高级权限为 v2 版本的多维表格支持该参数。是否是 v2 版本可调用[获取多维表格元数据<br>](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app/get)查看。<br>**示例值**：{"select_option_edit": {"单选1":0}}
block_roles | block_role\[\] | 否 | 针对仪表盘的权限设置。更新是，未设置该字段的情况下，保持旧值不变。设置`block_roles`为{}时，将所有仪表盘更新为默认权限，即所有仪表盘无权限。<br>**数据校验规则**：<br>- 长度范围：`0` ～ `100`
block_id | string | 是 | 多维表格仪表盘的唯一标识，以 blk 开头。获取方式：<br>- 在多维表格的 URL 地址栏中，`block_id` 是下图中高亮部分：<br>![image.png](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/a966d15323ee73c66b1e9a31d34ae6c7_x3ctncH2nO.png?height=575&lazyload=true&width=1397)<br>- 通过[列出仪表盘](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-dashboard/list)接口获取<br>**示例值**："blknkqrP3RqUkcAW"<br>**数据校验规则**：<br>- 长度范围：`0` ～ `100` 字符
block_perm | int | 是 | 仪表盘的权限<br>**示例值**：0<br>**可选值有**：<br>- 0：无权限<br>- 1：可阅读
base_rule | map&lt;string, int&gt; | 否 | 多维表格点位的权限。更新时，未设置`base_rule`字段时，所有点位保持旧值。设置`base_rule`字段为{}时，会将所有点位设置为默认值，即所有点位有权限。<br>可设置以下两种权限：<br>- `base_complex_edit` : 设置是否可以创建副本、下载、打印多维表格<br>- `copy`: 设置是否可以复制多维表格内容<br>该参数类型为 map，其中 key 是权限点位名称，value 是权限开关。value 枚举值有：<br>- `0`：无权限<br>- `1`：有权限<br>**注意**：仅高级权限为 v2 版本的多维表格支持该参数。是否是 v2 版本可调用[获取多维表格元数据<br>](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app/get)查看。<br>**示例值**：{"base_complex_edit": 1, "copy": 0}

### 请求体示例
```json
{
    "role_name": "自定义权限1",
    "table_roles": [
        {
            "table_perm": 0,
            "table_name": "数据表1",
            "table_id": "tblKz5D60T4JlfcT",
            "rec_rule": {
                "conditions": [
                    {
                        "field_name": "单选",
                        "operator": "is",
                        "value": [
                            "optbdVHf4q"
                        ]
                    }
                ],
                "conjunction": "and",
                "other_perm": 1
            },
            "other_rec_rule": {
                "conditions": [
                    {
                        "field_name": "单选",
                        "operator": "is",
                        "value": [
                            "optbdVHf4q"
                        ]
                    }
                ],
                "conjunction": "and"
            },
            "field_perm": {
                "姓名": 1,
                "年龄": 2
            },
            "allow_add_record": true,
            "allow_delete_record": true,
            "view_perm": 2,
            "view_rules": {
                "vewEYknYcC": 0
            },
            "field_action_rules": {
                "select_option_edit": {
                    "单选1": 0
                }
            }
        }
    ],
    "block_roles": [
        {
            "block_id": "blknkqrP3RqUkcAW",
            "block_perm": 0
        }
    ],
    "base_rule": {
        "base_complex_edit": 1,
        "copy": 0
    }
}
```

## 响应

### 响应体

名称 | 类型 | 描述
---|---|---
code | int | 错误码，非 0 表示失败
msg | string | 错误描述
data | \- | \-
role | role | 自定义角色
role_name | string | 自定义角色名称
table_roles | table_role\[\] | 针对数据表的权限设置
table_perm | int | 数据表权限。<br>**提示**：**协作者可编辑自己的记录** 和 **可编辑指定字段** 是 **可编辑记录** 的特殊情况，可通过指定 `rec_rule` 或 `field_perm` 参数实现相同的效果。<br>**可选值有**：<br>- 0：无权限<br>- 1：可阅读<br>- 2：可编辑<br>- 4：可管理
table_name | string | 数据表名
table_id | string | 数据表 ID。详情参考[数据表 table](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/bitable-overview#8ff3bb0b)。
rec_rule | rec_rule | 记录筛选条件，当 `table_perm` 为 1 或 2 时生效。用于指定可编辑或可阅读的记录。
conditions | rec_rule_condition\[\] | 记录筛选条件，用于指定可编辑或可阅读的记录。
field_name | string | 条件字段的名称。记录筛选条件是“创建人包含访问者本人”时，此参数值为 ""。
operator | string | 条件运算符<br>**可选值有**：<br>- is：等于<br>- isNot：不等于<br>- contains：包含<br>- doesNotContain：不包含<br>- isEmpty：为空<br>- isNotEmpty：不为空
value | string\[\] | 条件的值，可以是单个值或多个值的数组。详情参考[字段目标值（value）填写说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table-record/record-filter-guide#3e0fd644)。
field_type | int | 字段类型
conjunction | string | 多个筛选条件的关系<br>**可选值有**：<br>- and：与<br>- or：或
perm | int | rec_rule 的记录对应的权限<br>**可选值有**：<br>- 1：仅可阅读<br>- 2：可编辑
other_perm | int | 其他记录权限<br>**可选值有**：<br>- 0：禁止查看<br>- 1：仅可阅读
other_rec_rule | other_rec_rule | 记录筛选条件，在 `rec_rule.other_perm` 为 0 时生效。对于未命中 `rec_rule` 的记录，通过 `other_rec_rule` 指定可阅读记录范围；此时，既未命中 `rec_rule`、也未命中 `other_rec_rule` 的记录会被禁止阅读。
conditions | rec_rule_condition\[\] | 记录筛选条件
field_name | string | 字段名
operator | string | 运算符<br>**可选值有**：<br>- is：等于<br>- isNot：不等于<br>- contains：包含<br>- doesNotContain：不包含<br>- isEmpty：为空<br>- isNotEmpty：不为空
value | string\[\] | 条件的值，可以是单个值或多个值的数组。详情参考[字段目标值（value）填写说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table-record/record-filter-guide#3e0fd644)。
field_type | int | 字段类型
conjunction | string | 多个筛选条件的关系<br>**可选值有**：<br>- and：与<br>- or：或
perm | int | 规则筛选记录对应的权限<br>**可选值有**：<br>- 1：仅可阅读<br>- 2：可编辑
field_perm | map&lt;string, int&gt; | 字段权限，仅在 table_perm 为 2 时有意义，设置字段可编辑或可阅读权限
allow_add_record | boolean | 新增记录权限，仅在 table_perm 为 2 时有意义，用于设置记录是否可以新增
allow_delete_record | boolean | 删除记录权限，仅在 table_perm 为 2 时有意义，用于设置记录是否可以删除
view_perm | int | 视图权限<br>**可选值有**：<br>- 1：可阅读<br>- 2：可编辑
view_rules | map&lt;string, int&gt; | 可读的视图集合，仅在 view_perm 为 1 （视图为可阅读）时生效。<br>- 未设置时，表示所有视图可读。<br>- 设置后，表示设置的视图可读，未设置的视图无权限。<br>该参数类型为 map，其中 key 是视图 ID，value 是视图对应的权限。value 枚举值有：<br>- `0`：无权限<br>- `1`：可阅读
field_action_rules | map&lt;string, map&lt;string, int&gt;&gt; | 字段点位的权限配置，仅可配置单多选字段、附件字段。点位的枚举值有：<br>-  `select_option_edit` : 选项配置点位，配置是否可增删改单、多选选项，未设置表示无权限。<br>- `attachment_export`: 附件操作权限点位，配置是否可导出附件，未设置表示可导出。<br>该参数类型为两层 map 结构，其中 key 是字段点位权限，value 是字段权限集合。字段权限集合也是一个 map 结构，其中 key 是字段名称，value 是字段点位权限：<br>- `0`：无权限<br>- `1`：有权限
role_id | string | 自定义权限的id
block_roles | block_role\[\] | block权限
block_id | string | Block ID
block_perm | int | Block权限<br>**可选值有**：<br>- 0：无权限<br>- 1：可阅读
block_type | string | Block类型<br>**可选值有**：<br>- dashboard：仪表盘
base_rule | map&lt;string, int&gt; | 多维表格点位的权限。<br>- 未设置时，表示自定义角色拥有所有点位权限。<br>- 设置时，可设置以下两种权限：<br>-  `base_complex_edit` : 设置是否可以创建副本、下载、打印多维表格<br>- `copy`: 设置是否可以复制多维表格内容<br>该参数类型为 map，其中 key 是权限点位名称，value 是权限开关。value 枚举值有：<br>- `0`：无权限<br>- `1`：有权限

### 响应体示例
```json
{
    "code": 0,
    "msg": "success",
    "data": {
        "role": {
            "role_name": "自定义权限1",
            "table_roles": [
                {
                    "table_perm": 0,
                    "table_name": "数据表1",
                    "table_id": "tblKz5D60T4JlfcT",
                    "rec_rule": {
                        "conditions": [
                            {
                                "field_name": "单选",
                                "operator": "is",
                                "value": [
                                    "optbdVHf4q"
                                ],
                                "field_type": 3
                            }
                        ],
                        "conjunction": "and",
                        "perm": 1,
                        "other_perm": 1
                    },
                    "other_rec_rule": {
                        "conditions": [
                            {
                                "field_name": "单选",
                                "operator": "is",
                                "value": [
                                    "optbdVHf4q"
                                ],
                                "field_type": 3
                            }
                        ],
                        "conjunction": "and",
                        "perm": 1
                    },
                    "field_perm": {
                        "姓名": 1,
                        "年龄": 2
                    },
                    "allow_add_record": true,
                    "allow_delete_record": true,
                    "view_perm": 2,
                    "view_rules": {
                        "vewEYknYcC": 0
                    },
                    "field_action_rules": {
                        "select_option_edit": {
                            "单选1": 0
                        }
                    }
                }
            ],
            "role_id": "roljRpwIUt",
            "block_roles": [
                {
                    "block_id": "blknkqrP3RqUkcAW",
                    "block_perm": 0,
                    "block_type": "dashboard"
                }
            ],
            "base_rule": {
                "duplicate": 1,
                "copy": 2
            }
        }
    }
}
```

### 错误码

HTTP状态码 | 错误码 | 描述 | 排查建议
---|---|---|---
200 | 1254000 | WrongRequestJson | 请求体错误
200 | 1254001 | WrongRequestBody | 请求体错误
200 | 1254002 | Fail | 导致报 1254002 错误码的场景较多，请参考以下建议排查：<br>- 如果单次操作的内容变更较大，请尝试在单次操作中减少数据量<br>- 如果你并发调用了接口，请尝试控制请求间隔，稍后重试<br>- 如果在知识库（wiki）中创建多维表格，请检查你是否使用了知识库[创建知识空间节点](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/wiki-v2/space-node/create)接口创建多维表格。在此场景下不能使用[创建多维表格](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app/create)接口<br>- 请检查接口参数是否有误。例如，在分页查询多维表格时，传递了无效的 page_token，或传递了错误的数据表的 table_id<br>- 如果该报错偶尔发生，可能是服务器超时或不稳定，请重试解决
200 | 1254003 | WrongBaseToken | app_token 错误。app_token 是多维表格 App 的唯一标识。不同形态的多维表格，其 `app_token` 的获取方式不同：<br>- 如果多维表格的 URL 以 ==**feishu.cn/base**== 开头，该多维表格的 `app_token` 是下图高亮部分：<br>![app_token.png](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/6916f8cfac4045ba6585b90e3afdfb0a_GxbfkJHZBa.png?height=766&lazyload=true&width=3004)<br>- 如果多维表格的 URL 以 ==**feishu.cn/wiki**== 开头，你需调用知识库相关[获取知识空间节点信息](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/wiki-v2/space/get_node)接口获取多维表格的 app_token。当 `obj_type` 的值为 `bitable` 时，`obj_token` 字段的值才是多维表格的 `app_token`。<br>了解更多，参考[多维表格 app_token 获取方式](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/bitable-overview#-752212c)。
200 | 1254010 | ReqConvError | 请求错误
400 | 1254032 | InvalidRoleName | 自定义角色名无效
400 | 1254033 | RoleNameDuplicated | 自定义角色名重复
400 | 1254036 | Bitable is copying, please try again later. | 复制多维表格为异步操作，该错误码表示当前多维表格仍在复制中，在复制期间无法操作当前多维表格。需要等待复制完成后再操作
200 | 1254040 | BaseTokenNotFound | app_token 不存在。app_token 是多维表格 App 的唯一标识。不同形态的多维表格，其 `app_token` 的获取方式不同：<br>- 如果多维表格的 URL 以 ==**feishu.cn/base**== 开头，该多维表格的 `app_token` 是下图高亮部分：<br>![app_token.png](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/6916f8cfac4045ba6585b90e3afdfb0a_GxbfkJHZBa.png?height=766&lazyload=true&width=3004)<br>- 如果多维表格的 URL 以 ==**feishu.cn/wiki**== 开头，你需调用知识库相关[获取知识空间节点信息](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/wiki-v2/space/get_node)接口获取多维表格的 app_token。当 `obj_type` 的值为 `bitable` 时，`obj_token` 字段的值才是多维表格的 `app_token`。<br>了解更多，参考[多维表格 app_token 获取方式](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/bitable-overview#-752212c)。
404 | 1254047 | RoleIdNotFound | role_id 不存在。role_id 是多维表格高级权限中自定义角色的唯一标识，以 `rol` 开头。可通过[列出自定义角色](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-role/list)接口获取。
400 | 1254110 | RoleExceedLimit | 自定义角色数量超限，限制 30 条
200 | 1254290 | TooManyRequest | 请求过快，稍后重试
400 | 1254301 | OperationTypeError | 多维表格未开启高级权限或不支持开启高级权限
403 | 1254304 | Only Available For Business and Enterprise Editions | 仅企业版和旗舰版飞书支持行列权限
200 | 1255001 | InternalError | 内部错误，请联系[技术支持](https://applink.feishu.cn/TLJpeNdW)
200 | 1255002 | Something went wrong. Please contact technical support at https://applink.feishu.cn/client/helpdesk/open?id=6626260912531570952 | Something went wrong. Please contact technical support at https://applink.feishu.cn/client/helpdesk/open?id=6626260912531570952
200 | 1255003 | MarshalError | 序列化错误，请联系[技术支持](https://applink.feishu.cn/TLJpeNdW)
200 | 1255004 | UmMarshalError | 反序列化错误，请联系[技术支持](https://applink.feishu.cn/TLJpeNdW)
504 | 1255040 | Request timed out, please try again later | 请求超时，进行重试

