karuo-ai/02_卡人（水）/水桥_平台对接/智能纪要/参考资料/飞书妙记权限申请指南.md

飞书妙记权限申请指南

2026-03-11 | 解决 tenant_access_token 调用妙记 API 返回 2091005 的问题

---

问题现状

调用方式	结果	原因
tenant_access_token + Open API	2091005 permission deny	应用未配置妙记 scope
Cookie + Web API（/minutes/api/export）	✅ 成功	走用户 Session，绕过应用权限
user_access_token + Open API	可行（需重新授权）	用户身份有妙记阅读权限

---

解决方案 A：在开发者后台申请妙记权限（推荐）

步骤

1. 打开飞书开发者后台：https://open.feishu.cn/app/cli_a48818290ef8100d
2. 左侧菜单 → 权限管理
3. 搜索以下权限并申请：

权限名称	scope	说明
获取妙记信息	minutes:minute 或 minutes:minute:readonly	获取妙记标题、时长、封面等
获取妙记转写内容	minutes:transcript 或 minutes:transcript:readonly	获取文字记录正文
获取妙记统计	minutes:statistics:readonly	获取统计数据

4. 提交审核 → 企业管理员审批通过
5. 通过后，tenant_access_token 即可直接调用妙记 Open API

验证

python3 feishu_auth_helper.py test --token obcnc53697q9mj6h1go6v25e

---

解决方案 B：重新获取 user_access_token

当应用权限审批较慢，或需要访问用户个人妙记时：

步骤

1. 生成授权链接：

python3 feishu_auth_helper.py auth-url

2. 在浏览器中打开输出的 URL，用飞书账号授权

3. 授权后页面会跳转，从 URL 中提取 code 参数

4. 用 code 换取 token：

python3 feishu_auth_helper.py exchange --code <URL中的code>

5. 获得的 access_token 和 refresh_token 更新到 运营中枢/工作台/00_账号与API索引.md

注意

• user_access_token 有效期约 2 小时，refresh_token 有效期约 30 天
• 需要在飞书开发者后台配置重定向 URI
• 当前应用的 redirect_uri 为 https://open.feishu.cn

---

解决方案 C：Cookie 方案（当前使用，已自动化）

无需任何审批，5 级自动 fallback：

cookie_minutes.txt → 环境变量 → browser_cookie3 → Cursor 浏览器 → 手动

一键刷新

python3 feishu_auth_helper.py refresh-cookie

优缺点

• ✅ 无需审批、即时生效
• ✅ 5 级 fallback 高可用
• ❌ Cookie 会过期（通常数小时到数天）
• ❌ 依赖浏览器曾访问过飞书页面

---

总结：三种方案优先级

优先级	方案	适用场景	稳定性
1	应用权限 + tenant_token	日常自动化、脚本定时任务	最高（token 自动刷新）
2	Cookie 5 级 fallback	妙记文字/视频下载	中（需定期刷新）
3	user_access_token	特殊场景、全权限	低（需手动授权）