2.9 KiB
2.9 KiB
飞书「创建多维表格」权限开通说明（给卡罗维亚）
用途：上传 JSON 时若类型为多维表格，需在飞书创建多维表格；当前报错缺少用户身份下的
bitable:app、base:app:create。请按下列步骤在开放平台开通，并让使用人重新授权。
一、问题现象
- 运行
upload_json_to_feishu_doc.py上传「水流程规划」等 JSON 时，检测为多维表格并尝试创建，接口返回： - 错误：
required one of these privileges under the user identity: [bitable:app, base:app:create] - 说明：创建多维表格接口要求的是用户身份权限（user_access_token），不是应用身份权限。
二、开通步骤（开放平台侧）
-
打开权限管理
- 登录 飞书开放平台 → 进入应用「卡若私域」→ 左侧 权限管理。
-
点击「开通权限」
- 在弹窗顶部的 Tab 切到「用户身份权限 user_access_token」（不要用「应用身份权限」）。
- 搜索框输入：
bitable或base:app。
-
勾选并保存
- 勾选：查看、评论、编辑和管理多维表格（权限 ID：
bitable:app）。 - 若有 创建多维表格 / base:app:create 相关权限，一并勾选。
- 保存后，在「版本管理与发布」中发布新版本（否则权限不生效）。
- 勾选：查看、评论、编辑和管理多维表格（权限 ID：
-
提醒
- 页面提示「版本发布后，当前修改方可生效」→ 务必完成发布。
三、用户重新授权（必须）
- 权限开通并发布后，已授权用户不会自动获得新权限，必须重新走一遍授权，拿到新的 access_token / refresh_token 才会带上述权限。
- 推荐：本机执行一次 强制重新授权（会删除旧 Token 并打开带「多维表格」权限的授权页）：
完成飞书扫码/授权后，再运行上传或批量上传脚本即可。
python3 脚本/feishu_force_reauth.py - 或：运行
python3 脚本/auto_log.py在需要时按提示授权；或打开http://localhost:5050的授权入口重新授权。
四、脚本侧已做的修改
- auto_log.py：授权链接的
scope已增加bitable:app、base:app:create，新授权会申请多维表格权限。 - feishu_api.py：
/api/auth/url返回的授权地址已带上相同 scope。 - 无需改脚本即可支持「上传 JSON → 按类型创建多维表格」，只需完成上述权限开通 + 重新授权。
五、小结（发给卡罗维亚/管理员）
- 要开的权限：用户身份权限 →
bitable:app（及若有则勾选base:app:create）。 - 要做的动作：开通 → 发布新版本 → 通知使用人重新授权一次。
- 参考链接：飞书错误说明 https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-resolve-error-99991679
文档维护：卡若AI 水桥 · 2026-03-02