1. 知识库
MaxKB 接口文档-v2.x.x
  • 系统用户
    • 创建系统用户
    • 删除系统用户
    • 修改系统用户信息
    • 获取系统用户信息
    • 获取系统用户列表
    • 获取系统用户分页列表
    • 修改系统用户密码
    • 批量设置系统用户角色
    • 批量删除系统用户
    • 系统用户登录
    • LDAP用户登录
    • 系统用户登出
    • 获取系统用户认证配置
  • 角色管理
    • 获取当前系统用户角色列表
    • 获取角色列表
    • 创建或更新角色
    • 删除角色
    • 系统角色添加成员
    • 获取角色权限
    • 系统角色移除成员
    • 获取系统角色成员列表
    • 获取角色权限模板
  • 对话用户
    • 创建对话用户
    • 删除对话用户
    • 修改对话用户信息
    • 获取对话用户信息
    • 修改对话用户密码
    • 批量删除对话用户
    • 获取对话用户列表
    • 同步对话用户
    • 获取对话用户同步类型
    • 获取对话用户分页列表
    • 创建对话用户组
    • 修改对话用户组
    • 删除对话用户组
    • 获取对话用户组列表
    • 获取对话用户组信息
    • 添加成员到对话用户组
    • 移除成员到对话用户组
    • 对话用户登出
    • 获取对话用户认证类型
    • 获取对话用户平台信息
    • 测试对话用户 LDAP 连接
    • 获取对话用户认证配置
  • 智能体
    • 对话日志
      • 添加至知识库
      • 获取对话列表
      • 分页获取对话列表
      • 获取对话记录列表
      • 分页获取对话记录列表
      • 获取对话记录详情
      • 获取标记段落列表
    • 获取智能体信息
    • 获取智能体对话ID
    • 智能体对话
    • 智能体密码认证
    • 获取智能体列表
    • 获取智能体详情
    • 删除智能体
    • 获取智能体访问限制信息
    • 移动智能体
    • 获取智能体临时会话ID
    • 发布智能体
    • 获取智能体设置
    • 智能体提问次数统计
    • 分页获取智能体列表
    • 批量删除智能体
    • 批量移动智能体
    • 创建智能体密钥
    • 删除智能体 API 密钥
    • 获取智能体 API 密钥列表
    • 获取智能体版本列表
    • 获取智能体版本详情
    • 分页获取智能体版本列表
  • 知识库
    • 同步 Web 知识库
      PUT
    • 获取知识工作流
      GET
    • 获取知识库标签
      GET
    • 获取文档
      GET
    • 创建文档
      POST
    • 分页获取文档
      GET
    • 获取文档详情
      GET
    • 取消任务
      PUT
    • 下载源文件
      GET
    • 导出文档
      GET
    • 导出ZIP文档
      GET
    • 获取文档标签
      GET
    • 批量创建文档
      PUT
    • 获取分段列表
      GET
    • 创建飞书文档列表
      POST
    • 批量同步飞书文档
      PUT
    • 同步飞书文档
      PUT
    • 获取表格模板
      GET
    • 获取问答模板
      GET
    • 获取段落列表
      GET
    • 创建段落
      POST
    • 分页获取段落列表
      GET
    • 获取段落详情
      GET
    • 获取段落问题列表
      GET
    • 添加关联问题
      POST
    • 调整段落位置
      PUT
    • 关联问题
      PUT
    • 取消关联问题
      PUT
    • 获取知识库问题列表
      GET
    • 分页获取知识库问题列表
      GET
    • 创建问题
      POST
    • 删除问题
      DELETE
    • 修改问题
      PUT
    • 获取问题关联段落列表
      GET
    • 批量删除问题
      PUT
    • 获取知识库标签
      GET
    • 创建知识库标签
      POST
    • 替换原文档
      POST
    • 获取飞书数据源文档信息
      POST
    • 上传飞书文档
      POST
    • 查看工作流知识库执行状态
      GET
  • 触发器
    • 获取资源触发器列表
    • 获取资源触发器详情
    • 删除资源触发器
    • 获取触发器列表-(未完成)
    • 分页获取触发器列表
    • 获取触发器详情
    • 删除触发器
    • 批量 启用/禁用 触发器
    • 批量删除触发器
  • 文件
    • 获取对话文件
    • 上传对话文件
    • 获取文件
    • 上传文件
  • 文件夹
    • 获取文件夹树
    • 获取文件夹
    • 创建文件夹
    • 更新文件夹
    • 删除文件夹
  • 其他
    • 查看外观设置
    • 获取邮箱设置
    • 测试邮箱设置
    • 发送邮件给当前系统用户
    • 修改当前系统用户密码
    • 修改当前对话用户密码-(用户token)
    • 获取当前系统用户信息
    • 获取当前对话用户信息-(用户token)
    • 获取当前系统用户授权信息
    • 获取当前工作空间系统用户信息
    • 获取当前工作空间系统用户列表
    • 获取资源对话用户组列表
    • 获取资源对话用户组分页列表
    • 编辑资源对话用户组列表
    • 获取资源对话用户列表
    • 获取资源对话用户分页列表
    • 编辑资源对话用户列表
    • 获取许可证信息
    • 获取分页操作日志
    • 获取菜单操作日志
    • 获取当前用户角色列表
    • 获取系统API密钥列表
  • 数据模型
    • 示例数据模型
      • Pet
      • Category
      • Tag
  1. 知识库

上传飞书文档

开发中
POST
{{Host}}/admin/api/workspace/{workspace_id}/knowledge/{knowledge_id}/upload_document

请求参数

Authorization
在 Header 添加参数
Authorization
,其值为在 Bearer 之后拼接 Token
示例:
Authorization: Bearer ********************
Path 参数

Header 参数

Body 参数application/json必填

示例
{
    "data_source": {
        "file_list": [
            {
                "leaf": true,
                "created_time": "1754385453",
                "modified_time": "1775100402",
                "name": "MaxKB文档02",
                "owner_id": "ou_9d56555d1a88ae4c1bbf021ebb12ee04",
                "parent_token": "SiYkfJsT7lCBtWdB4ubcDFrfnyb",
                "token": "YBubddyzioD13PxxAuBcZMBTnjd",
                "type": "docx",
                "url": "https://mcnh9lofsi78.feishu.cn/docx/YBubddyzioD13PxxAuBcZMBTnjd"
            },
            {
                "leaf": true,
                "created_time": "1769682177",
                "modified_time": "1769682177",
                "name": "MaxKB 对话用户对接 CAS 副本",
                "owner_id": "ou_9d56555d1a88ae4c1bbf021ebb12ee04",
                "parent_token": "SiYkfJsT7lCBtWdB4ubcDFrfnyb",
                "token": "IFKjdFEsAoOrKNxV12TclIS6noh",
                "type": "docx",
                "url": "https://mcnh9lofsi78.feishu.cn/docx/IFKjdFEsAoOrKNxV12TclIS6noh"
            },
            {
                "leaf": true,
                "created_time": "1769681734",
                "modified_time": "1769681743",
                "name": "测试",
                "owner_id": "ou_9d56555d1a88ae4c1bbf021ebb12ee04",
                "parent_token": "SiYkfJsT7lCBtWdB4ubcDFrfnyb",
                "token": "GgYqdPVDJoYSi7xxDF3c552qnQb",
                "type": "docx",
                "url": "https://mcnh9lofsi78.feishu.cn/docx/GgYqdPVDJoYSi7xxDF3c552qnQb"
            },
            {
                "leaf": true,
                "created_time": "1754385830",
                "modified_time": "1754401379",
                "name": "MaxKB文档01",
                "owner_id": "ou_9d56555d1a88ae4c1bbf021ebb12ee04",
                "parent_token": "SiYkfJsT7lCBtWdB4ubcDFrfnyb",
                "token": "ArRbdNWzlo6PbNxRwkecT9XLnVg",
                "type": "docx",
                "url": "https://mcnh9lofsi78.feishu.cn/docx/ArRbdNWzlo6PbNxRwkecT9XLnVg"
            }
        ],
        // 工作流知识库中上传文档组件的 node_id (可在 data-workflow-nodes 中根据 stepName 获取)
        "node_id": "50dc7681-0908-44aa-ba4b-3533fbbb5491"
    }
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --globoff '{{Host}}/admin/api/workspace/default/knowledge/019d4bf9-3625-7412-a8a1-e84c1d5e1d2e/upload_document' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "data_source": {
        "file_list": [
            {
                "leaf": true,
                "created_time": "1754385453",
                "modified_time": "1775100402",
                "name": "MaxKB文档02",
                "owner_id": "ou_9d56555d1a88ae4c1bbf021ebb12ee04",
                "parent_token": "SiYkfJsT7lCBtWdB4ubcDFrfnyb",
                "token": "YBubddyzioD13PxxAuBcZMBTnjd",
                "type": "docx",
                "url": "https://mcnh9lofsi78.feishu.cn/docx/YBubddyzioD13PxxAuBcZMBTnjd"
            },
            {
                "leaf": true,
                "created_time": "1769682177",
                "modified_time": "1769682177",
                "name": "MaxKB 对话用户对接 CAS 副本",
                "owner_id": "ou_9d56555d1a88ae4c1bbf021ebb12ee04",
                "parent_token": "SiYkfJsT7lCBtWdB4ubcDFrfnyb",
                "token": "IFKjdFEsAoOrKNxV12TclIS6noh",
                "type": "docx",
                "url": "https://mcnh9lofsi78.feishu.cn/docx/IFKjdFEsAoOrKNxV12TclIS6noh"
            },
            {
                "leaf": true,
                "created_time": "1769681734",
                "modified_time": "1769681743",
                "name": "测试",
                "owner_id": "ou_9d56555d1a88ae4c1bbf021ebb12ee04",
                "parent_token": "SiYkfJsT7lCBtWdB4ubcDFrfnyb",
                "token": "GgYqdPVDJoYSi7xxDF3c552qnQb",
                "type": "docx",
                "url": "https://mcnh9lofsi78.feishu.cn/docx/GgYqdPVDJoYSi7xxDF3c552qnQb"
            },
            {
                "leaf": true,
                "created_time": "1754385830",
                "modified_time": "1754401379",
                "name": "MaxKB文档01",
                "owner_id": "ou_9d56555d1a88ae4c1bbf021ebb12ee04",
                "parent_token": "SiYkfJsT7lCBtWdB4ubcDFrfnyb",
                "token": "ArRbdNWzlo6PbNxRwkecT9XLnVg",
                "type": "docx",
                "url": "https://mcnh9lofsi78.feishu.cn/docx/ArRbdNWzlo6PbNxRwkecT9XLnVg"
            }
        ],
        // 工作流知识库中上传文档组件的 node_id (可在 data-workflow-nodes 中根据 stepName 获取)
        "node_id": "50dc7681-0908-44aa-ba4b-3533fbbb5491"
    }
}'

返回响应

🟢200成功
application/json
Bodyapplication/json

示例
{}
修改于 2026-06-16 07:28:50
上一页
获取飞书数据源文档信息
下一页
查看工作流知识库执行状态
Built with