获取知识空间子节点列表

此接口用于分页获取Wiki节点的子节点列表。

此接口为分页接口。由于权限过滤，可能返回列表为空，但分页标记（has_more）为true，可以继续分页请求。

知识库权限要求，当前使用的 access token 所代表的应用或用户拥有：

父节点阅读权限

错误码

HTTP状态码	错误码	描述	排查建议
400	131001	rpc fail	服务报错，请稍后重试，或者拿响应体的header头里的x-tt-logid咨询oncall定位。
400	131002	param err	通常为传参有误，例如数据类型不匹配。请查看具体接口报错信息，报错不明确时请咨询oncall。
400	131003	out of limit	超出操作限制，例如节点数量限制。请参阅下表。原/目标知识空间总节点数不超过40万。原/目标知识空间目录树不超过50层。目的父节点下单层节点数不超过2000。单次移动节点数（带子节点）不超过2000。
400	131004	invalid user	非法用户。请咨询oncall。
400	131005	not found	未找到相关数据，例如id不存在。相关报错信息参考：member not found：用户不是知识空间成员（管理员），无法删除。identity not found: userid不存在，无法添加/删除成员。space not found：知识空间不存在node not found：节点不存在document not found：文档不存在报错不明确时请咨询oncall。
400	131006	permission denied	权限拒绝，相关报错信息参考：wiki space permission denied：需要为知识空间成员（管理员）node permission denied：读操作时需要有节点阅读权限。写操作（创建、移动等）需要节点容器编辑权限。no source parent node permission：需要原父节点容器编辑权限。no destination parent node permission：需要目的父节点容器编辑权限。only task creator can query status：为任务创建者（用户或应用/机器人）如果使用tenant_access_token调用，请确保应用/机器人为知识空间成员。参阅如何将应用添加为知识库管理员（成员）。当接口报错信息不明确时，请咨询oncall。
400	131007	internal err	服务内部错误，请勿重试，拿返回值的header头里的x-tt-logid咨询oncall定位。
400	131008	already exist	数据已存在，请勿重复操作。

{ "code": 0, "msg": "success", "data": { "items": [ { "space_id": "6946843325487912356", "node_token": "wikcnKQ1k3p******8Vabcef", "obj_token": "doccnzAaOD******Wabcdef", "obj_type": "doc", "parent_node_token": "wikcnKQ1k3p******8Vabcef", "node_type": "origin", "origin_node_token": "wikcnKQ1k3p******8Vabcef", "origin_space_id": "6946843325487912356", "has_child": false, "title": "标题", "obj_create_time": "1642402428", "obj_edit_time": "1642402428", "node_create_time": "1642402428", "creator": "ou_xxxxx", "owner": "ou_xxxxx" } ], "page_token": "6946843325487906839", "has_more": true } }

请求参数

Path 参数

space_id

string

必需

知识空间id 示例值："6946843325487906839"

示例值:

6946843325487906839

Query 参数

page_size

string

可选

分页大小示例值：10 数据校验规则：最大值：50

示例值:

page_token

string

可选

分页标记，第一次请求不填，表示从头开始遍历；分页查询结果还有更多项时会同时返回新的 page_token，下次遍历可采用该 page_token 获取查询结果示例值："6946843325487456878"

示例值:

6946843325487456878

parent_node_token

string

可选

父节点token 示例值："wikcnKQ1k3pcuo5uSK4t8VN6kVf"

示例值:

wikcnKQ1k3pcuo5uSK4t8VN6kVf

Header 参数

Authorization

string

必需

tenant_access_token 或 user_access_token 值格式："Bearer access_token" 示例值："Bearer u-7f1bcd13fc57d46bac21793a18e560"

默认值:

Bearer {{access_token}}

返回响应

🟢200成功

application/json

Body

code

integer

必需

错误码，非 0 表示失败

msg

string

错误描述

必需

data

object

必需

items

array [object {15}]

数据列表

必需

page_token

string

必需

分页标记，当 has_more 为 true 时，会同时返回新的 page_token，否则不返回 page_token

has_more

boolean

是否还有更多项

必需

获取知识空间子节点列表

错误码#

请求参数

返回响应

错误码