获取知识空间列表

此接口用于获取有权限访问的知识空间列表。

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

对于知识空间各项属性描述请参阅获取知识空间信息

使用tenant 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": [ { "name": "知识空间", "description": "知识空间描述", "space_id": "1565676577122621" } ], "page_token": "1565676577122621", "has_more": true } }

请求参数

Query 参数

page_size

string

分页大小

可选

示例值:

page_token

string

可选

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

示例值:

1565676577122621

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 {3}]

数据列表

必需

page_token

string

必需

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

has_more

boolean

是否还有更多项

必需

获取知识空间列表

错误码#

请求参数

返回响应

错误码