知识库知识库外部开放接口
分页获取空间目录
按 id 升序分页返回空间下的有效目录,原 getParentIdList 保持不变。
请求体
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| spaceId | int64 | 是 | 知识库空间 ID。 | 123456 |
| pageNo | int32 | 否 | 页码,从 1 开始。 | |
| pageSize | int32 | 否 | 每页数量,最大 500。 |
返回参数
| 名称 | 类型 | 描述 | 示例值 |
|---|---|---|---|
| code | int32 | 业务响应码。200 表示成功;失败时为 RetCode 中定义的业务码。 | 200 |
| msg | string | 响应说明。成功通常为 ok;失败时为错误原因。 | ok |
| message | string | 兼容字段,部分异常场景可能返回错误说明。 | |
| data | object | 目录分页数据。 | |
| └total | int32 | ||
| └list | object[] | ||
| └docId | int64 | 文档 ID。 | 987654 |
| └spaceId | int64 | 所属空间 ID。 | 123456 |
| └docName | string | 文档或目录名称。 | 退款规则 |
| └parentId | int64 | 父目录 ID;根目录通常为 0。 | 0 |
| └docType | string | 文档类型。 | |
| └creator | string | 创建人账号或 GUID。 | zhangsan |
| └creatorName | string | 创建人姓名。 | 张三 |
| └createTime | int64 | 创建时间,毫秒时间戳。 | 1781245600000 |
| └editor | string | 最近编辑人账号或 GUID。 | lisi |
| └editorName | string | 最近编辑人姓名。 | 李四 |
| └editTime | int64 | 最近编辑时间,毫秒时间戳。 | 1781249200000 |
| └deleter | string | 删除人账号或 GUID,仅已删除数据返回。 | wangwu |
| └deleterName | string | 删除人姓名,仅已删除数据返回。 | 王五 |
| └deleteTime | int64 | 删除时间,毫秒时间戳,仅已删除数据返回。 | 1781252800000 |
| └deleteFlag | boolean | 是否已删除。 | false |
错误码
| 状态码 | 描述 |
|---|---|
| 400 | 请求参数错误。常见业务码:402 MISS_PARAM、403 ERR_PARAM。 |
| 401 | OPENAPI_AUTH 鉴权失败。常见业务码:405 AUTH_FAILED。 |
| 404 | 资源不存在。常见业务码:404 NOT_FOUND、408 SPACE_NOT_EXISTS。 |
| 500 | 服务内部异常。常见业务码:500 ERROR。 |
postEndpoint
/api/athena/openApi/external/getParentIdListByPagecurl -X POST "https://b.163.com/api/athena/openApi/external/getParentIdListByPage" \ -H "Content-Type: application/json" \ -d '{ "spaceId": 123456 }'{
"code": 200,
"msg": "ok",
"message": "string",
"data": {
"total": 0,
"list": [
{
"docId": 987654,
"spaceId": 123456,
"docName": "退款规则",
"parentId": 0,
"docType": "PDF",
"creator": "zhangsan",
"creatorName": "张三",
"createTime": 1781245600000,
"editor": "lisi",
"editorName": "李四",
"editTime": 1781249200000,
"deleter": "wangwu",
"deleterName": "王五",
"deleteTime": 1781252800000,
"deleteFlag": false
}
]
}
}{
"code": 200,
"msg": "ok",
"message": "string"
}{
"code": 200,
"msg": "ok",
"message": "string"
}{
"code": 200,
"msg": "ok",
"message": "string"
}{
"code": 200,
"msg": "ok",
"message": "string"
}这篇文档有帮助吗?