Mud Tools

接口名称

Wiki 知识库节点（用户权限）- (IFeishuUserV2WikiNodes)

功能描述

知识空间中的节点，支持文档、表格等多种文件类型。文件是各种类型的文件的统称，泛指云空间内所有的文件。每个文件都有唯一 token 作为标识。

本接口提供以用户身份对知识空间节点进行管理的能力，除基础节点操作外，还支持 Wiki 搜索功能，适用于需要用户主动操作的场景。

参考文档

飞书 Wiki 概述

函数列表

函数名称	功能描述	认证方式	HTTP 方法
`CreateSpaceNodeAsync`	创建知识空间节点	用户令牌	POST
`GetNodeSpaceInfoAsync`	获取知识空间节点信息	用户令牌	GET
`GetSpaceNodesPageListAsync`	获取知识空间子节点列表	用户令牌	GET
`MoveSpaceNodeAsync`	移动知识空间节点	用户令牌	POST
`UpdateTitleSpaceNodeAsync`	更新知识空间节点标题	用户令牌	POST
`CopySpaceNodeAsync`	创建知识空间节点副本	用户令牌	POST
`MoveDocsToWikiSpaceNodeAsync`	移动云空间文档至知识空间	用户令牌	POST
`GetTaskByIdAsync`	获取 Wiki 异步任务结果	用户令牌	GET
`SearchPageListAsync`	搜索 Wiki 节点	用户令牌	POST

函数详细内容

创建知识空间节点

函数名称：创建知识空间节点

函数签名：

csharp

Task<FeishuApiResult<SpaceNodeResult>?> CreateSpaceNodeAsync(
    [Path] string space_id,
    [Body] CreateSpaceNodeRequest createSpaceNodeRequest,
    CancellationToken cancellationToken = default);

认证：用户令牌

参数：

参数名	类型	必填	说明
`space_id`	`string`	✅ 必填	知识空间 ID
`createSpaceNodeRequest`	`CreateSpaceNodeRequest`	✅ 必填	创建节点请求体
`cancellationToken`	`CancellationToken`	⚪ 可选	取消操作令牌

CreateSpaceNodeRequest 参数：

参数名	类型	必填	说明
`obj_type`	`string`	✅ 必填	文档类型：docx、sheet、mindnote、bitable、file、slides
`parent_node_token`	`string?`	⚪ 可选	父节点 token，为空则创建为一级节点
`node_type`	`string`	✅ 必填	节点类型：origin（实体）、shortcut（快捷方式）
`origin_node_token`	`string?`	⚪ 可选	快捷方式对应的实体 node_token
`title`	`string?`	⚪ 可选	文档标题

响应：

json

{
  "code": 0,
  "msg": "success",
  "data": {
    "node": {
      "space_id": "6870403571079249922",
      "node_token": "wikcnKQ1k3p******8Vabcef",
      "obj_token": "docx******xxx",
      "obj_type": "docx",
      "parent_node_token": null,
      "node_type": "origin",
      "title": "产品需求文档"
    }
  }
}

获取知识空间节点信息

函数名称：获取知识空间节点信息

函数签名：

csharp

Task<FeishuApiResult<SpaceNodeResult>?> GetNodeSpaceInfoAsync(
    [Query("token")] string token,
    [Query("obj_type")] string? obj_type = "wiki",
    CancellationToken cancellationToken = default);

认证：用户令牌

参数：

参数名	类型	必填	说明
`token`	`string`	✅ 必填	知识库节点 token 或云文档实际 token
`obj_type`	`string?`	⚪ 可选	文档类型，默认 wiki
`cancellationToken`	`CancellationToken`	⚪ 可选	取消操作令牌

说明：

知识库节点 token：URL 中 token 前为 wiki
云文档实际 token：URL 中 token 前为 docx、base、sheets 等

获取知识空间子节点列表

函数名称：获取知识空间子节点列表

函数签名：

csharp

Task<FeishuApiPageListResult<SpaceNodeInfo>?> GetSpaceNodesPageListAsync(
    [Path] string space_id,
    [Query("parent_node_token")] string? parent_node_token = null,
    [Query("page_size")] int page_size = 10,
    [Query("page_token")] string? page_token = null,
    CancellationToken cancellationToken = default);

认证：用户令牌

参数：

参数名	类型	必填	说明
`space_id`	`string`	✅ 必填	知识空间 ID
`parent_node_token`	`string?`	⚪ 可选	父节点 token，为空获取一级节点
`page_size`	`int`	⚪ 可选	分页大小，默认 10
`page_token`	`string?`	⚪ 可选	分页标记
`cancellationToken`	`CancellationToken`	⚪ 可选	取消操作令牌

移动知识空间节点

函数名称：移动知识空间节点

函数签名：

csharp

Task<FeishuApiResult<SpaceNodeResult>?> MoveSpaceNodeAsync(
    [Path] string space_id,
    [Path] string node_token,
    [Body] MoveSpaceNodeRequest moveSpaceNodeRequest,
    CancellationToken cancellationToken = default);

认证：用户令牌

参数：

参数名	类型	必填	说明
`space_id`	`string`	✅ 必填	知识空间 ID
`node_token`	`string`	✅ 必填	需要移动的节点 token
`moveSpaceNodeRequest`	`MoveSpaceNodeRequest`	✅ 必填	移动节点请求体
`cancellationToken`	`CancellationToken`	⚪ 可选	取消操作令牌

MoveSpaceNodeRequest 参数：

参数名	类型	必填	说明
`target_parent_token`	`string?`	⚪ 可选	目标父节点 token
`target_space_id`	`string?`	⚪ 可选	目标知识空间 ID

说明：

支持跨知识空间移动
如果有子节点，会携带子节点一起移动

更新知识空间节点标题

函数名称：更新知识空间节点标题

函数签名：

csharp

Task<FeishuNullDataApiResult?> UpdateTitleSpaceNodeAsync(
    [Path] string space_id,
    [Path] string node_token,
    [Body] UpdateTitleSpaceNodeRequest updateTitleSpaceNodeRequest,
    CancellationToken cancellationToken = default);

认证：用户令牌

参数：

参数名	类型	必填	说明
`space_id`	`string`	✅ 必填	知识空间 ID
`node_token`	`string`	✅ 必填	节点 token
`updateTitleSpaceNodeRequest`	`UpdateTitleSpaceNodeRequest`	✅ 必填	更新标题请求体
`cancellationToken`	`CancellationToken`	⚪ 可选	取消操作令牌

UpdateTitleSpaceNodeRequest 参数：

参数名	类型	必填	说明
`title`	`string`	✅ 必填	节点新标题

创建知识空间节点副本

函数名称：创建知识空间节点副本

函数签名：

csharp

Task<FeishuApiResult<SpaceNodeResult>?> CopySpaceNodeAsync(
    [Path] string space_id,
    [Path] string node_token,
    [Body] CopySpaceNodeRequest copySpaceNodeRequest,
    CancellationToken cancellationToken = default);

认证：用户令牌

参数：

参数名	类型	必填	说明
`space_id`	`string`	✅ 必填	知识空间 ID
`node_token`	`string`	✅ 必填	节点 token
`copySpaceNodeRequest`	`CopySpaceNodeRequest`	✅ 必填	复制节点请求体
`cancellationToken`	`CancellationToken`	⚪ 可选	取消操作令牌

CopySpaceNodeRequest 参数：

参数名	类型	必填	说明
`target_parent_token`	`string?`	⚪ 可选	目标父节点 Token
`target_space_id`	`string?`	⚪ 可选	目标知识空间 ID
`title`	`string?`	⚪ 可选	复制后的新标题

移动云空间文档至知识空间

函数名称：移动云空间文档至知识空间

函数签名：

csharp

Task<FeishuApiResult<MoveDocsToWikiSpaceNodeResult>?> MoveDocsToWikiSpaceNodeAsync(
    [Path] string space_id,
    [Body] MoveDocsToWikiSpaceNodeRequest moveDocsToWikiSpaceNode,
    CancellationToken cancellationToken = default);

认证：用户令牌

参数：

参数名	类型	必填	说明
`space_id`	`string`	✅ 必填	知识空间 ID
`moveDocsToWikiSpaceNode`	`MoveDocsToWikiSpaceNodeRequest`	✅ 必填	移动文档请求体
`cancellationToken`	`CancellationToken`	⚪ 可选	取消操作令牌

MoveDocsToWikiSpaceNodeRequest 参数：

参数名	类型	必填	说明
`parent_wiki_token`	`string?`	⚪ 可选	父节点 token，为空则移动为一级节点
`obj_type`	`string`	✅ 必填	文档类型：doc、sheet、bitable、docx 等
`obj_token`	`string`	✅ 必填	文档 token
`apply`	`bool?`	⚪ 可选	无权限时是否申请移动

说明：

该接口为异步接口

获取 Wiki 异步任务结果

函数名称：获取 Wiki 异步任务结果

函数签名：

csharp

Task<FeishuApiResult<GetTaskResult>?> GetTaskByIdAsync(
    [Path] string task_id,
    [Query("task_type")] string task_type = "move",
    CancellationToken cancellationToken = default);

认证：用户令牌

参数：

参数名	类型	必填	说明
`task_id`	`string`	✅ 必填	任务 ID
`task_type`	`string`	⚪ 可选	任务类型，默认 move
`cancellationToken`	`CancellationToken`	⚪ 可选	取消操作令牌

搜索 Wiki 节点

函数名称：搜索 Wiki 节点

函数签名：

csharp

Task<FeishuApiPageListResult<WikiSearchResult>?> SearchPageListAsync(
    [Body] WikiSearchRequest wikiSearchRequest,
    [Query("page_size")] int page_size = 10,
    [Query("page_token")] string? page_token = null,
    CancellationToken cancellationToken = default);

认证：用户令牌

参数：

参数名	类型	必填	说明
`wikiSearchRequest`	`WikiSearchRequest`	✅ 必填	搜索请求体
`page_size`	`int`	⚪ 可选	分页大小，默认 10
`page_token`	`string?`	⚪ 可选	分页标记
`cancellationToken`	`CancellationToken`	⚪ 可选	取消操作令牌

WikiSearchRequest 参数：

参数名	类型	必填	说明
`query`	`string`	✅ 必填	搜索关键词，长度不超过 50 个字符
`space_id`	`string?`	⚪ 可选	知识空间 ID，为空搜索全部
`node_id`	`string?`	⚪ 可选	节点 ID，搜索该节点及其子节点

说明：

只能查找自己可见的 Wiki
Wiki 存在但搜索不到可能是没有查看权限

响应：

json

{
  "code": 0,
  "msg": "success",
  "data": {
    "items": [
      {
        "node_id": "wikcnKQ1k3p******8Vabcef",
        "space_id": "6870403571079249922",
        "obj_type": 16,
        "obj_token": "docx******xxx",
        "title": "产品需求文档",
        "url": "https://xxx.feishu.cn/wiki/xxx",
        "icon": "https://xxx"
      }
    ],
    "page_token": "xxx",
    "has_more": false
  }
}

代码示例

使用用户权限搜索和管理 Wiki 节点

csharp

public class WikiNodeUserService
{
    private readonly IFeishuUserV2WikiNodes _wikiNodesClient;

    public WikiNodeUserService(IFeishuUserV2WikiNodes wikiNodesClient)
    {
        _wikiNodesClient = wikiNodesClient;
    }

    // 搜索 Wiki
    public async Task<List<WikiSearchResult>> SearchWikiAsync(
        string keyword, 
        string? spaceId = null)
    {
        var results = new List<WikiSearchResult>();
        string? pageToken = null;

        do
        {
            var request = new WikiSearchRequest
            {
                Query = keyword,
                SpaceId = spaceId
            };

            var result = await _wikiNodesClient.SearchPageListAsync(
                request, 
                page_size: 20,
                page_token: pageToken);

            if (result?.Data?.Items != null)
            {
                results.AddRange(result.Data.Items);
            }

            pageToken = result?.Data?.PageToken;
        } while (!string.IsNullOrEmpty(pageToken));

        return results;
    }

    // 在指定空间下创建文档
    public async Task<SpaceNodeInfo?> CreateDocumentAsync(
        string spaceId, 
        string title, 
        string? parentNodeToken = null)
    {
        var request = new CreateSpaceNodeRequest
        {
            ObjType = "docx",
            NodeType = "origin",
            Title = title,
            ParentNodeToken = parentNodeToken
        };

        var result = await _wikiNodesClient.CreateSpaceNodeAsync(spaceId, request);
        return result?.Data?.Node;
    }

    // 更新节点标题
    public async Task<bool> UpdateNodeTitleAsync(
        string spaceId, 
        string nodeToken, 
        string newTitle)
    {
        var request = new UpdateTitleSpaceNodeRequest
        {
            Title = newTitle
        };

        var result = await _wikiNodesClient.UpdateTitleSpaceNodeAsync(
            spaceId, 
            nodeToken, 
            request);

        return result?.Code == 0;
    }

    // 复制节点到另一个空间
    public async Task<SpaceNodeInfo?> CopyNodeToSpaceAsync(
        string sourceSpaceId,
        string nodeToken,
        string targetSpaceId,
        string? newTitle = null)
    {
        var request = new CopySpaceNodeRequest
        {
            TargetSpaceId = targetSpaceId,
            Title = newTitle
        };

        var result = await _wikiNodesClient.CopySpaceNodeAsync(
            sourceSpaceId, 
            nodeToken, 
            request);

        return result?.Data?.Node;
    }
}

接口名称 ​

功能描述 ​

参考文档 ​

函数列表 ​

函数详细内容 ​

创建知识空间节点 ​

获取知识空间节点信息 ​

获取知识空间子节点列表 ​

移动知识空间节点 ​

更新知识空间节点标题 ​

创建知识空间节点副本 ​

移动云空间文档至知识空间 ​

获取 Wiki 异步任务结果 ​

搜索 Wiki 节点 ​

代码示例 ​

使用用户权限搜索和管理 Wiki 节点 ​

接口名称

功能描述

参考文档

函数列表

函数详细内容

创建知识空间节点

获取知识空间节点信息

获取知识空间子节点列表

移动知识空间节点

更新知识空间节点标题

创建知识空间节点副本

移动云空间文档至知识空间

获取 Wiki 异步任务结果

搜索 Wiki 节点

代码示例

使用用户权限搜索和管理 Wiki 节点