DirectoryCreate - 新建目录
更新时间：2024-11-05
API访问域名
| 请求方式 | POST |
|---|---|
| base url | https://keyue.cloud.baidu.com |
| 后缀接口 | /open/v1/api/v2/directory/create |
| Authentication | token为API Key |
说明
新增知识目录，默认存在默认目录，id = 0
请求参数
Header参数
| 名称 | 类型 | 必选 | 中文名 | 说明 |
|---|---|---|---|---|
| Content-Type | string | 是 | 内容类型 | 固定值：application/json |
| token | string | 是 | API KEY | 集成-API-API Key处获取。 详细获取方式参考：准备工作 |
| uid | string | 是 | 用户ID | 鼠标移动至页面右上角账户头像即可获取。 详细获取方式参考：准备工作 |
| username | string | 是 | 用户名 | 鼠标移动至页面右上角账户头像即可获取。 详细获取方式参考：准备工作 |
Body参数
| 名称 | 类型 | 必选 | 中文名 | 说明 |
|---|---|---|---|---|
| name | string | 是 | 目录名称 | 目录4 |
| parentId | string | 是 | 父级目录ID | 0，默认目录为0 |
| version | integer | 是 | 版本 | 5，可以根据查询列表获取最新版本号 |
响应参数
| 名称 | 类型 | 必填 | 中文名 | 说明 |
|---|---|---|---|---|
| time | integer | 是 | 时间 | 1716863109583 |
| data | object | 是 | 数据 | 数据 |
| data \ hasPerm | 否 | |||
| data \ id | string | 是 | 目录ID | 7e701600-0b67-4752-9eec-11534f0c3e76 |
| data \ name | string | 是 | 目录名称 | 目录4 |
| data \ parentId | string | 是 | 父级目录ID | 0 |
| data \ sort | integer | 否 | 排序 | 4 |
| data \ version | integer | 是 | 版本 | 6 |
| code | integer | 是 | 状态码 | 200为成功 |
| msg | string | 是 | 状态信息 | OK为正常 |
请求示例
curl --location 'https://keyue.cloud.baidu.com/open/v1/api/v2/directory/create' \
--header 'token: ced7f43f-2e2c-49d4-a265-af0ab3961794' \
--header 'Content-Type: application/json' \
--header 'uid: cf7d9692703d45d1b5517a30ab3efa53' \
--header 'username: pnstest5' \
--data '{
"name": "目录4",
"parentId": "0",
"version": 5
}'响应示例
{
"time": 1716863109583,
"data": {
"hasPerm": null,
"id": "7e701600-0b67-4752-9eec-11534f0c3e76",
"name": "目录4",
"parentId": "0",
"sort": 4,
"version": 6
},
"code": 200,
"msg": "OK"
}{
"msg": "目录列表数据版本不一致，请刷新重试",
"tip": "",
"code": 4000526,
"requestId": "f51ece4298694674bcfb0cb942c47716"
}