搜索 Wiki

搜索 Wiki，用户通过关键词查询 Wiki，只能查找自己可见的 wiki

Note注： Wiki 存在，但用户搜索不到并不一定是搜索有问题，可能是用户没有查看该 Wiki 的权限

请求

基本
HTTP URL	https://open.feishu.cn/open-apis/wiki/v2/nodes/search
HTTP Method	POST
HTTP Content-Type	application/json; charset=utf-8
凭证要求	user_access_token
权限要求	查看知识库

查询参数

属性名称	类型	必填	描述
page_token	string	否	下一页的分页 token，首页不需要填写，根据返回的 token 获取下一页数据
page_size	int	否	本页返回数量的最大值 0 < page_size <= 50 默认 20

请求体

属性名称	类型	必填	描述
query	string	是	搜索关键词，长度不超过50个字符
space_id	string	否	文档所属的知识空间ID，为空搜索全部知识空间
node_id	string	否	不为空搜索该节点及其所有子节点，为空搜索所有 wiki（使用 node_id 过滤必须传入 space_id）

请求体示例

{
    "query": "搜索关键词",
    "space_id": "xxxxxxx",
    "node_id": "xxxx"
}

响应

响应体

Name	Type	Description
code	int	错误码，非 0 表示失败
msg	string	错误描述
data	-	-
∟items	list	wiki 信息数组
∟node_id	string	wiki 节点的 token
∟space_id	string	wiki 所属知识空间 Id
∟obj_type	int	wiki 类型, 参考文档类型表
∟obj_token	string	节点的真实文档的 token，如果要获取或编辑节点内容，需要使用此 token 调用对应的接口
∟parent_id	string	暂未生效，一律返回空
∟sort_id	int	该知识库文档的序号，从 1 开始计数
∟title	string	wiki 标题
∟url	string	wiki 的访问 url
∟icon	string	wiki 对应图标的 url
∟page_token	string	如果 has_more 为 true 则返回下一页的 token
∟has_more	bool	是否还有下一页数据

文档类型表

obj_type	说明
1	Doc
2	Sheet
3	Bitable
4	Mindnote
5	File
6	Slide(已废弃)
7	Wiki
8	Docx
9	Folder
10	Catalog
11	Slides

响应体示例

{
  "code": 0,
  "data": {
    "has_more": false,
    "items": [
      {
        "node_id": "BAgPwq6lIi5Nykk0E5fcJeabcef",
        "obj_token": "AcnMdexrlokOShxe40Fc0Oabcef",
        "obj_type": 8,
        "parent_id": "",
        "sort_id": 1,
        "space_id": "7307457194084925443",
        "title": "欢迎使用知识库 / Welcome to Wiki",
        "url": "https://sample.feishu.cn/wiki/BAgPwq6lIi5Nykk0E5fcJeabcef"
      }
    ]
  },
  "msg": "success"
}

错误码

HTTP 状态码	错误码	描述	排查建议
200	10001	invalid param	参数错误，参考文档检查输入参数
200	10002	network anomaly, please try again	后端服务异常或网络异常，可重新请求