飞书云文档API操作详细介绍

最新推荐文章于 2026-09-15 14:29:37 发布

原创

最新推荐文章于 2026-09-15 14:29:37 发布 · 1.5w 阅读

1.场景分析

公司内部很多文档都是由多人进行维护的，随时发生变更，因此在利用这些数据的时候就需要直接读取云文档的数据，从而执行下一步动作。团队云文档api执行权限一般需要管理员审核才能使用。如果你就是管理员，那么恭喜你，你可以随意。下面具体介绍下如何开通云文档api操作权限，并使用python调用各种API。

2.开通云文档API操作权限

搜索开发者小助手，点击开发资源找到开发文档
点击开发者后台
创建企业应用
开通所需权限
版本发布，权限申请后发步才能进入审批环节

申请成功后，飞书会发送一条权限开通成功的消息，收到之后，恭喜你可以进行下一步操作。

3.给予自建应用云文档编辑权限

access_token一般常用有两种：
tenant_access_token：访问应用非自有资源

访问其他用户的文档、电子表格、多维表格需要取得文档所有者的授权
需要应用开启机器人能力
需要所有者打开对应的文档，在页面右上方「…」->「…更多」-> 「添加文档应用」入口添加
访问知识库需要获得知识库管理员的授权
需要应用开启机器人能力
需要知识库管理员打开知识库节点文档，在页面右上方「…」->「…更多」-> 「添加文档应用」入口添加

user_access_token：访问用户非自有资源

访问其他用户的文档、电子表格、多维表格需要取得文档所有者的授权
需要所有者打开对应的文档，在页面右上方「分享」入口添加
访问其他用户文件夹需要取得文件夹所有者的授权
需要所有者在我的空间找到目标文件夹，右键菜单中「分享」入口添加
访问知识库需要获得知识库管理员的授权
需要知识库管理员打开知识库节点文档，在页面右上方「分享」入口添加

注：user_access_token需要用户授权，脚本获取不到，建议使用tenant_access_token，之后想要编辑文档可以在文档中添加应用

云文档添加自己创建的应用，需要有文档的管理者权限

4.获取app_id和app_secret

5.程序调用api

飞书api开发文档:https://open.feishu.cn/document/server-docs/docs/faq

api调用实战

import json
import requests
import pymysql

app_id = "cli_xxxxx"
app_secret = "xxxx"

#获取tenant_access_token

url1 = "https://open.feishu.cn/open-apis/auth/v3/tenant_access_token/internal"
payload = {
   
   
    "app_id": app_id,
    "app_secret": app_secret
}
response = requests.post(url1, json=payload)
# print(response.json())
tenant_access_token = response.json(