更新自定义角色
PUT
https://open.feishu.cn/open-apis/bitable/v1/apps/{app_token}/roles/{role_id}
更新自定义角色是全量更新，会完全覆盖旧的自定义角色设置
错误码
| HTTP状态码 | 错误码 | 描述 | 排查建议 |
|---|---|---|---|
| 200 | 1254000 | WrongRequestJson | 请求体错误 |
| 200 | 1254001 | WrongRequestBody | 请求体错误 |
| 200 | 1254002 | Fail | 内部错误，有疑问可咨询客服 |
| 200 | 1254003 | WrongBaseToken | app_token 错误 |
| 200 | 1254010 | ReqConvError | 请求错误 |
| 400 | 1254032 | InvalidRoleName | 自定义角色名无效 |
| 400 | 1254033 | RoleNameDuplicated | 自定义角色名重复 |
| 400 | 1254036 | Bitable is copying, please try again later. | 多维表格副本复制中，稍后重试 |
| 200 | 1254040 | BaseTokenNotFound | app_token 不存在 |
| 404 | 1254047 | RoleIdNotFound | role_id 不存在 |
| 400 | 1254110 | RoleExceedLimit | 自定义角色数量超限，限制30条 |
| 200 | 1254290 | TooManyRequest | 请求过快，稍后重试 |
| 200 | 1254291 | Write conflict | 同一个数据表(table) 不支持并发调用写接口，请检查是否存在并发调用写接口。写接口包括：新增、修改、删除记录；新增、修改、删除字段；修改表单；修改视图等。 |
| 400 | 1254301 | OperationTypeError | 多维表格未开启高级权限或不支持开启高级权限 |
| 403 | 1254302 | RolePermNotAllow | 无访问权限, 常由表格开启了高级权限造成, 请在高级权限设置中添加一个包含应用的群, 给予这个群读写权限 |
| 403 | 1254304 | Only Available For Business and Enterprise Editions | 仅企业版和旗舰版飞书支持行列权限 |
| 200 | 1255001 | InternalError | 内部错误，有疑问可咨询客服 |
| 200 | 1255002 | RpcError | 内部错误，有疑问可咨询客服 |
| 200 | 1255003 | MarshalError | 序列化错误，有疑问可咨询客服 |
| 200 | 1255004 | UmMarshalError | 反序列化错误 |
| 504 | 1255040 | 请求超时 | 进行重试 |
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request PUT 'https://open.feishu.cn/open-apis/bitable/v1/apps/appbcbWCzen6D8dezhoCH2RpMAh/roles/roljRpwIUt' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
"role_name": "role1",
"table_roles": [
{
"table_name": "table1",
"table_id": "tblFIgBzKEq75HSE",
"table_perm": 2,
"allow_add_record": false,
"allow_delete_record": true,
"rec_rule": {
"conditions": [
{
"field_name": "单选",
"operator": "is",
"value": [
"optbdVHf4q"
]
},
{
"field_name": "人员" // 人员 包含 访问者本人
},
{
"field_name": "" // 创建人 包含 访问者本人
}
],
"conjunction": "or",
"other_perm": 0
},
"field_perm": {
"年龄": 2,
"单选": 1
}
},
{
"table_name": "table2",
"table_id": "tblMPI6OC1aWvTvs",
"table_perm": 1,
"rec_rule": {
"conditions": [
{
"field_name": "人员"
},
{
"field_name": "多选",
"operator": "is",
"value": [
"opttgKOTSt",
"optWcdXR0W"
]
}
],
"conjunction": "and"
}
},
{
"table_name": "table3",
"table_id": "tblmkLF7Tg6IWbRb",
"table_perm": 0
},
{
"table_name": "table4",
"table_id": "tbl5VQHDTms19Qe7",
"table_perm": 4
}
],
"block_roles": [
{
"block_id": "blknkqrP3RqUkcAW",
"block_perm": 0
},
{
"block_id": "blkAjxjWKvbBi7EA",
"block_perm": 1
}
]
}'响应示例响应示例
{
"data": {
"role": {
"role_name": "role1",
"table_roles": [
{
"table_name": "table1",
"table_id": "tblFIgBzKEq75HSE",
"table_perm": 2,
"addrecords_perm": false,
"deleterecords_perm": true,
"rec_rule": {
"conjunction": "or",
"conditions": [
{
"field_name": "单选",
"operator": "is",
"field_type": 3,
"value": [
"optbdVHf4q"
]
},
{
"value": null,
"field_name": "人员",
"operator": "contains",
"field_type": 11
},
{
"operator": "contains",
"field_type": 1003,
"value": null,
"field_name": ""
}
],
"other_perm": 0
},
"field_perm": {
"单选": 1,
"年龄": 2
}
},
{
"table_name": "table2",
"table_id": "tblMPI6OC1aWvTvs",
"table_perm": 1,
"rec_rule": {
"conditions": [
{
"field_name": "人员",
"operator": "contains",
"field_type": 11,
"value": null
},
{
"operator": "is",
"field_type": 4,
"value": [
"opttgKOTSt",
"optWcdXR0W"
],
"field_name": "多选"
}
],
"other_perm": 0,
"conjunction": "and"
}
},
{
"table_name": "table3",
"table_id": "tblmkLF7Tg6IWbRb",
"table_perm": 0
},
{
"table_name": "table4",
"table_id": "tbl5VQHDTms19Qe7",
"table_perm": 4
}
],
"block_roles": [
{
"block_id": "blknkqrP3RqUkcAW",
"block_perm": 0
},
{
"block_id": "blkAjxjWKvbBi7EA",
"block_perm": 1
}
]
}
},
"code": 0,
"msg": "success"
}请求参数
Path 参数
app_token
string
必需
示例值:
appbcbWCzen6D8dezhoCH2RpMAh
role_id
string
自定义角色的id
示例值:
roljRpwIUt
Header 参数
Authorization
string
必需
默认值:
Bearer {{access_token}}
Content-Type
string
必需
默认值:
application/json; charset=utf-8
Body 参数application/json
返回响应
扫码加入交流群修改于 2023-01-18 08:39:37