知识库分类
知识库分类管理接口，支持分类的增删改查及树形结构查询。
知识库分类列表
接口地址：/kl/api/saas/knowledge/category/list
请求方法：GET
权限要求：knowledge_category READ
接口描述：分页查询知识库分类列表
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| pageNo | Integer | 否 | 当前页码，默认1 |
| pageSize | Integer | 否 | 页码大小，默认10 |
| name | String | 否 | 分类名称（模糊查询） |
| parentCode | String | 否 | 父级分类编码，默认"0" |
响应示例
{
"code": 8200,
"message": "操作成功",
"data": [
{
"id": 1,
"code": "001",
"name": "技术文档",
"parentCode": "0",
"grade": 1,
"children": [],
"creator": "admin",
"createTime": "2024-01-01 10:00:00",
"modifier": "admin",
"modifierTime": "2024-01-01 10:00:00",
"sort": 1
}
],
"total": 1,
"totalPage": 1,
"pageNo": 1,
"pageSize": 10
}
请求示例
curl -X GET "${domain}/kl/api/saas/knowledge/category/list?pageNo=1&pageSize=10" \
-H "Authorization: Bearer tk_xxxxxxxxxxxxx" \
-H "Content-Type: application/json"
知识库分类树
接口地址：/kl/api/saas/knowledge/category/tree
请求方法：GET
权限要求：knowledge_category READ
接口描述：查询知识库分类树形结构
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| name | String | 否 | 分类名称（模糊查询） |
| parentCode | String | 否 | 父级分类编码 |
响应示例
{
"code": 8200,
"message": "操作成功",
"data": [
{
"id": 1,
"code": "001",
"name": "技术文档",
"parentCode": "0",
"grade": 1,
"children": [
{
"id": 2,
"code": "001001",
"name": "Java开发",
"parentCode": "001",
"grade": 2,
"children": []
}
]
}
]
}
新增知识库分类
接口地址：/kl/api/saas/knowledge/category/add
请求方法：POST
权限要求：knowledge_category WRITE
接口描述：新增知识库分类
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| name | String | 是 | 分类名称 |
| parentCode | String | 是 | 父级分类编码，默认"0" |
RequestBody示例
{
"name": "技术文档",
"parentCode": "0"
}
响应示例
{
"code": 8200,
"message": "新增成功",
"data": "分类ID"
}
修改知识库分类
接口地址：/kl/api/saas/knowledge/category/update
请求方法：PUT
权限要求：knowledge_category WRITE
接口描述：修改知识库分类信息
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| id | Integer | 是 | 分类ID |
| name | String | 是 | 分类名称 |
RequestBody示例
{
"id": 1,
"name": "技术文档"
}
响应示例
{
"code": 8200,
"message": "修改成功",
"data": null
}
查询知识库分类详情
接口地址：/kl/api/saas/knowledge/category/queryById
请求方法：GET
权限要求：knowledge_category READ
接口描述：根据ID查询知识库分类详情
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| id | Integer | 是 | 分类ID |
响应示例
{
"code": 8200,
"message": "操作成功",
"data": {
"id": 1,
"code": "001",
"name": "技术文档",
"parentCode": "0",
"grade": 1,
"creator": "admin",
"createTime": "2024-01-01 10:00:00",
"modifier": "admin",
"modifierTime": "2024-01-01 10:00:00",
"sort": 1
}
}
删除知识库分类
接口地址：/kl/api/saas/knowledge/category/delete
请求方法：DELETE
权限要求：knowledge_category WRITE
接口描述：删除知识库分类
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| id | Integer | 是 | 分类ID |
响应示例
{
"code": 8200,
"message": "删除成功",
"data": "success"
}