# 获取知识库空间列表
- 此接口用于获取有权限访问的知识空间列表。
# 注意事项
- 如果没有知识库权限,返回列表为空。
- 此接口为分页接口。由于权限过滤,可能返回列表为空,但当分页标记(hasMore)为 true 时,可以继续分页请求。
# 请求
| 基本 | |
|---|---|
| HTTP URL | https://hi-gw.weizhipin.com/open-apis/zhishu/library/space/list |
| HTTP Method | GET |
| 支持的应用类型 | 自建应用 |
| 权限要求 开启任一权限即可 | 知识库相关接口 |
# 请求头
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| Authorization | string | 是 | user_access_token 值格式:"Bearer access_token"示例值:"Bearer t-7f1bcd13fc57d46bac21793a18e560" |
# 请求参数
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| pageSize | int | 否 | 分页大小 示例值:10 默认值:20 数据校验规则:最大值:50 |
| pageToken | string | 否 | 分页标记,第一次请求不填,表示从头开始遍历;分页查询结果还有更多项时会同时返回新的 pageToken,下次遍历可采用该 page_token 获取查询结果 示例值:"1565676577122621" |
# 响应
# 响应体
| 名称 | 类型 | 描述 |
|---|---|---|
| code | int | 错误码,非 0 表示失败 |
| message | string | 错误描述 |
| zpData | data | |
| --list | string | 文件visitCode |
| ----name | string | 知识库名称 |
| ----visitCode | string | 文件visitCode |
| ----type | String | 文件的类型 docs 则为轻文档 sheet 则为轻表格 bs 则为毕升文件 file 则为云文件 |
| ----createOpenId | string | 文件创建者openId |
| ----createTime | long | 文件创建时间,单位为ms |
| ----latestModifyTime | long | 文件最后更新时间,单位为ms |
| --pageToken | string | 分页标记,当 hasMore 为 true 时,会同时返回新的 pageToken,否则不返回 pageToken |
| --hasMore | String | 是否还有更多项 |