查询不同知识点下的知识维度

该接口用于查询不同知识点下的知识维度

请求方法

GET /sdk/knowledgeDimensions/findAllUseful/businessTypes/{type:^[1-9]\d*$}

请求参数(URL)

参数名 类型 必填 说明
type:^[1-9]\d*$ 字符串 是 知识类型：6(Q&A)、10(文件)、11(常用语)、12(常用链接)、13(知识模版)、14(文档)、16(GRAPH)、19(网站)、20(飞书知识库)、21(钉钉知识库)

请求参数(Query String)

参数名 类型 必填 说明
knowledgeBaseId 字符串 否 知识空间id
参数名 类型 必填 说明
Authorization 字符串 否 Bearer Token
Content-Type 字符串 否 内容类型

返回数据

属性名 类型 说明
code 整型 执行结果码,200代表成功
succeed 布尔值 请求是否成功
bizCode 字符串 业务代码
message 字符串 返回消息
data 数组 知识维度列表
paging 对象 分页信息

示例

请求

curl --location 'https://kcs.t1.in.tryudesk.com/api/sdk/knowledgeDimensions/findAllUseful/businessTypes/6?knowledgeBaseId=194' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJrbSIsImNvbXBhbnlJZCI6MzAwMDAwMDIsImFwcElkIjoiNDY3Yzk4N2EtMjk0YS00NDk2LTRhZDctYzIyM2Y4ZDdiZjhmIiwiaXNzIjoia20iLCJ1c2VyVHlwZSI6MiwiZXhwIjoxNzYyMjYwODMzLCJpYXQiOjE3NjIyNTc4MzMsInVzZXJJZCI6Mn0.Ua3IJNR9YJCZzTgWI6y7mhTOFNUb6jZWrzAtRjjWQzGwa5USW5FGY25i0g0_SOLeDhR178btQXYIa6hdT2YeG2aGIhkwDgxl36GfqMyB3X4KMwJ6zboa04yLWd7cGJKHX9Z6ys-OId2JPpZhERlAQLNvXnqLlnBDlMewj7p7ly4'

结果

{
  "succeed": true,
  "code": 200,
  "bizCode": "000000",
  "message": "OK",
  "visible": false,
  "paging": {
    "pageNum": 1,
    "pageSize": 1,
    "total": 1
  },
  "data": [
    {
      "id": 201,
      "knowledgeBaseId": 194,
      "dimensionName": "默认分类",
      "knowledgeType": "[1,2,3,4,5,6,7,9,10,11]",
      "isSystemLevel": 1,
      "isEdit": 0,
      "status": 1,
      "createTime": "2025-07-14 14:45:16",
      "updateTime": "2025-08-12 19:40:54",
      "createUserId": 2,
      "updateUserId": 2,
      "deleteFlag": 0
    }
  ]
}

根据知识维度查询分类列表

该接口用于根据知识维度查询分类列表

请求方法

GET /sdk/categories/businessTypes/{type:^[1-9]\d*$}

请求参数(URL)

参数名 类型 必填 说明
type:^[1-9]\d*$ 字符串 是 知识类型：6(Q&A)、10(文件)、11(常用语)、12(常用链接)、13(知识模版)、14(文档)、16(GRAPH)、19(网站)、20(飞书知识库)、21(钉钉知识库)

请求参数(Query String)

参数名 类型 必填 说明
knowledgeBaseId 字符串 否 知识空间id
knowledgeDimensionId 字符串 否 知识维度id

请求参数(Header)

参数名 类型 必填 说明
Authorization 字符串 否 Bearer Token
Content-Type 字符串 否 内容类型

返回数据

属性名 类型 说明
code 整型 执行结果码,200代表成功
succeed 布尔值 请求是否成功
bizCode 字符串 业务代码
message 字符串 返回消息
data 数组 分类列表
paging 对象 分页信息

示例

请求

curl --location 'https://kcs.t1.in.tryudesk.com/api/sdk/categories/businessTypes/14?knowledgeBaseId=225' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJrbSIsImNvbXBhbnlJZCI6MzAwMDAwMDIsImFwcElkIjoiNDY3Yzk4N2EtMjk0YS00NDk2LTRhZDctYzIyM2Y4ZDdiZjhmIiwiaXNzIjoia20iLCJ1c2VyVHlwZSI6MiwiZXhwIjoxNzYyMjYwODMzLCJpYXQiOjE3NjIyNTc4MzMsInVzZXJJZCI6Mn0.Ua3IJNR9YJCZzTgWI6y7mhTOFNUb6jZWrzAtRjjWQzGwa5USW5FGY25i0g0_SOLeDhR178btQXYIa6hdT2YeG2aGIhkwDgxl36GfqMyB3X4KMwJ6zboa04yLWd7cGJKHX9Z6ys-OId2JPpZhERlAQLNvXnqLlnBDlMewj7p7ly4'

结果

{
  "succeed": true,
  "code": 200,
  "bizCode": "000000",
  "message": "OK",
  "visible": false,
  "paging": {
    "pageNum": 1,
    "pageSize": 2,
    "total": 2
  },
  "data": [
    {
      "id": 11445,
      "name": "未分类",
      "parentId": 0,
      "parentIds": "0,",
      "level": 1,
      "order": 1,
      "knowledgeBaseId": 225,
      "categoryType": 0,
      "allowManage": 0,
      "createTime": "2025-08-05 19:27:10",
      "updateTime": "2025-10-21 17:02:24",
      "createUserId": 2,
      "updateUserId": 2,
      "knowledgeDimensionId": 409,
      "deleteFlag": 0,
      "categoryCreateBool": true,
      "categoryManageBool": true
    },
    {
      "id": 11522,
      "name": "12345",
      "parentId": 0,
      "parentIds": "0,",
      "level": 1,
      "order": 1,
      "knowledgeBaseId": 225,
      "categoryType": 1,
      "allowManage": 0,
      "langInfo": "[{\"name\":\"简体中文\",\"code\":\"ZH-CN\",\"value\":\"12345\"}]",
      "createTime": "2025-08-08 17:50:34",
      "updateTime": "2025-10-21 17:02:24",
      "createUserId": 2,
      "updateUserId": 2,
      "knowledgeDimensionId": 409,
      "deleteFlag": 0,
      "categoryCreateBool": true,
      "categoryManageBool": true
    }
  ]
}

新增分类

该接口用于新增分类

请求方法

POST /sdk/categories

请求参数(Request Body)

参数名 类型 必填 说明
name 字符串 是 分类名称
langInfo 字符串 是 多语言配置，如：[{\"name\":\"简体中文\",\"code\":\"ZH-CN\",\"value\":\"分类名称\"}]
knowledgeBaseId 整型 是 知识空间id
parentId 整型 是 父分类id，0表示一级分类
order 整型 是 排序id
knowledgeDimensionId 整型 是 知识维度id

请求参数(Header)

参数名 类型 必填 说明
Authorization 字符串 否 Bearer Token
Content-Type 字符串 否 内容类型

返回数据

属性名 类型 说明
code 整型 执行结果码,200代表成功
succeed 布尔值 请求是否成功
bizCode 字符串 业务代码
message 字符串 返回消息
data 对象 新增的分类信息

示例

请求

curl -X POST \
  https://demo.udesk.cn/sdk/categories \
  -H 'Authorization: Bearer {token}' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "这是子分类",
  "langInfo": "[{\"name\":\"简体中文\",\"code\":\"ZH-CN\",\"value\":\"这是子分类\"}]",
  "knowledgeBaseId": 196,
  "parentId": 11289,
  "order": 1,
  "knowledgeDimensionId": 203
}'

结果

{
  "succeed": true,
  "code": 200,
  "bizCode": "000000",
  "message": "OK",
  "visible": false,
  "data": {
    "id": 11390,
    "name": "这是子分类",
    "parentId": 11289,
    "parentIds": "0,11289,",
    "level": 2,
    "order": 1,
    "knowledgeBaseId": 196,
    "langInfo": "[{\"name\":\"简体中文\",\"code\":\"ZH-CN\",\"value\":\"这是子分类\"}]"
  }
}

更新分类

该接口用于更新分类

请求方法

PUT /sdk/categories/{id:^[1-9]\d*$}

请求参数(URL)

参数名 类型 必填 说明
id:^[1-9]\d*$ 字符串 是 分类ID

请求参数(Request Body)

参数名 类型 必填 说明
name 字符串 是 分类名称
langInfo 字符串 是 多语言配置，如：[{\"name\":\"简体中文\",\"code\":\"ZH-CN\",\"value\":\"分类名称\"}]
knowledgeBaseId 整型 是 知识空间id
parentId 整型 是 父分类id，0表示一级分类
order 整型 是 排序id
knowledgeDimensionId 整型 是 知识维度id

请求参数(Header)

参数名 类型 必填 说明
Authorization 字符串 否 Bearer Token
Content-Type 字符串 否 内容类型

返回数据

属性名 类型 说明
code 整型 执行结果码,200代表成功
succeed 布尔值 请求是否成功
bizCode 字符串 业务代码
message 字符串 返回消息

示例

请求

curl -X PUT \
  https://demo.udesk.cn/sdk/categories/11390 \
  -H 'Authorization: Bearer {token}' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "这是子分类",
  "langInfo": "[{\"name\":\"简体中文\",\"code\":\"ZH-CN\",\"value\":\"这是子分类\"}]",
  "knowledgeBaseId": 196,
  "parentId": 11289,
  "order": 1,
  "knowledgeDimensionId": 203
}'

结果

{
  "succeed": true,
  "code": 200,
  "bizCode": "000000",
  "message": "OK"
}