tomevault-io 飞书知识库
通过 Wiki v2 API 管理知识空间和页面节点。
Base URL: https://open.feishu.cn/open-apis/wiki/v2
认证与 Token 获取
从 feishu_skills 根目录执行共享脚本：
TOKEN="$(./scripts/get_feishu_token.sh)"
请求头统一使用 Authorization: Bearer ${TOKEN}。
如果业务接口返回 token 无效、过期或 401，强制刷新后仅重试一次原请求：
TOKEN="$(./scripts/get_feishu_token.sh --force-refresh)"
环境变量:
FEISHU_APP_IDFEISHU_APP_SECRET
本地缓存: ./.feishu_token_cache.json（未过期直接复用，默认提前 5 分钟刷新）
知识空间
| API | 端点 | 说明 |
|---|---|---|
| 创建空间 | POST /spaces |
{"name":"知识库名称"} |
| 获取列表 | GET /spaces |
- |
| 获取详情 | GET /spaces/{space_id} |
- |
⚠️ 权限穿透：空间创建后机器人默认无权维护。建议：
- 创建包含机器人的群组
- 在知识库【设置】添加该群组为"管理员"
- 机器人通过群组身份获得操作权
页面节点
| API | 端点 | 说明 |
|---|---|---|
| 创建节点 | POST /spaces/{space_id}/nodes |
创建 Wiki 页面 |
| 获取节点 | GET /spaces/{space_id}/nodes/{node_token} |
- |
| 移动节点 | POST /spaces/{space_id}/nodes/{node_token}/move |
- |
创建节点:
{
"obj_type": "docx",
"parent_node_token": "root",
"node_type": "origin",
"origin_node_token": "doxcnXXX",
"title": "页面标题"
}
obj_type: doc / sheet / mindnote / bitable / file / docx
最佳实践
- 群组授权法（解决权限问题）
- 先创建文档再关联（
origin_node_token） - 适合知识沉淀场景
Converted and distributed by TomeVault — claim your Tome and manage your conversions.