Mud Tools

Appearance

搜索文档 - 用户令牌（FeishuUserV2SearchDocWiki） ​

接口名称 ​

搜索文档（用户令牌） -（IFeishuUserV2SearchDocWiki）

功能描述 ​

提供以用户身份搜索飞书云文档的能力。飞书 AI 文档搜索根据搜索关键词（query）对当前用户可见的云文档进行搜索，搜索范围与当前用户的文档可见权限保持一致。支持搜索文档操作。

参考文档 ​

函数列表 ​

函数名称功能描述认证方式HTTP 方法
SearchDocWikiAsync搜索文档用户令牌POST

函数详细内容 ​

搜索文档 ​

用于根据搜索关键词（query）对当前用户可见的云文档进行搜索。

函数签名：

csharp
Task<FeishuApiResult<SearchDocWikiResult>?> SearchDocWikiAsync(
    [Body] SearchDocWikiRequest request,
    CancellationToken cancellationToken = default);

认证：用户令牌

参数：

参数名类型必填说明
requestSearchDocWikiRequest✅搜索文档请求体

响应：

json
{
  "code": 0,
  "msg": "success",
  "data": {
    "total": 100,
    "has_more": false,
    "page_token": "next_page_token",
    "res_units": [
      {
        "title_highlighted": "<h>飞书文档</h>使用指南",
        "summary_highlighted": "本文介绍<h>飞书文档</h>的创建、编辑与分享功能",
        "entity_type": "DOC",
        "result_meta": {
          "doc_types": "SHORTCUT",
          "update_time": 1766567446,
          "url": "https://www.feishu.cn/docs/dox-1234567890abcdef",
          "owner_name": "张三",
          "owner_id": "ou-7890123456abcdef",
          "token": "dox_9876543210fedcba"
        }
      }
    ]
  }
}

说明：以用户令牌调用时，搜索结果仅包含当前用户有权限查看的云文档。搜索结果按相关性返回，res_units 中的标题与摘要已包含 <h> 高亮标记；当 has_more 为 true 时，可使用返回的 page_token 继续拉取下一页结果。