知识库中台管理接口

调用openapi接口需要进行基于Appid+secretKey的OpenAPI鉴权

1. 查询知识库详情中QA知识点

请求方法POST
接口路径/openapi/kb/v1/open/kb/qa/list
接口说明查询知识库详情中QA知识点
请求头参数(Header)
参数名位置类型示例值
appidheaderstring1090
timestampheaderstring{{$date.timestamp}}
nonceheaderstring123456
signatureheaderstring
请求体参数(Body)
参数名类型
tenantIdstring
kbIdstring
categoryIdstring
qastring
effectStatusstring
qaIdstring
enablenull
createTimeStartstring
createTimeEndstring
updateTimeStartstring
updateTimeEndstring
请求示例{ "tenantId": "1090", "kbId": "2027309239167565824", "categoryId": "0", "qa": "", "effectStatus": "", "qaId": "", "enable": null, "createTimeStart": "", "createTimeEnd": "", "updateTimeStart": "", "updateTimeEnd": "" }响应说明
状态码说明
200
认证要求需要 Bearer Token 认证────────────────────────────────────────────────────────────

2. 增加知识库详情中QA知识点

请求方法POST
接口路径/openapi/kb/v1/open/kb/qa/add/kbid
接口说明增加知识库详情中QA知识点
请求体参数(Body)
参数名类型说明
tenantIdstring
userIdinteger
categoryIdinteger
questionstring
answerTypestring
answerstring
answerHyperTextstring
attachmentListarray数组,元素类型: string
effectiveboolean
effectiveStartTimenull
effectiveEndTimenull
keywordsarray数组,元素类型: string
similarQaListarray数组,元素类型: string
relationQaListarray数组,元素类型: integer
answerMethodstring
voiceIdinteger
请求示例{ "tenantId": "1090", "userId": "2027308192055377920", "categoryId": 1, "question": "我是一个普通问题", "answerType": "TEXT", "answer": "文本回复", "answerHyperText": "", "attachmentList": [], "effective": false, "effectiveStartTime": null, "effectiveEndTime": null, "keywords": [ "新的" ], "similarQaList": [ "普通的qa是怎样的", "普通的qa包含哪些内容" ], "relationQaList": [ "2027327901382037504" ], "answerMethod": "text", "voiceId": "1990664838198546432" }响应说明
状态码说明
200
认证要求此接口无需认证────────────────────────────────────────────────────────────

3. 更新知识库详情中QA知识点

请求方法PUT
接口路径/openapi/kb/v1/open/kb/qa/kbid/qaid
接口说明更新知识库详情中QA知识点
请求体参数(Body)
参数名类型说明
tenantIdstring
userIdinteger
categoryIdstring
questionstring
answerTypestring
answerstring
answerHyperTextstring
attachmentListarray数组,元素类型: string
effectiveboolean
effectiveStartTimestring
effectiveEndTimestring
keywordsarray数组,元素类型: string
similarQaListarray数组,元素类型: string
relationQaListarray数组,元素类型: string
answerMethodstring
voiceIdstring
请求示例{ "tenantId": "1090", "userId": "2027308192055377920", "categoryId": "1", "question": "我不是普通问题", "answerType": "TEXT", "answer": "文本回复", "answerHyperText": "", "attachmentList": [], "effective": false, "effectiveStartTime": "", "effectiveEndTime": "", "keywords": [ "新的" ], "similarQaList": [ "普通的qa是怎样的", "普通的qa包含哪些内容" ], "relationQaList": [ "2027327901382037504" ], "answerMethod": "text", "voiceId": "1990664838198546432" }响应说明
状态码说明
200
认证要求需要 Bearer Token 认证────────────────────────────────────────────────────────────

4. 删除知识库详情中QA知识点

请求方法DELETE
接口路径/openapi/kb/v1/open/kb/qa/delete
接口说明删除知识库详情中QA知识点
请求体参数(Body)
参数名类型说明
tenantIdstring
userIdinteger
kbIdstring
qaIdstring
请求示例{ "tenantId": "1090", "userId": "2027308192055377920", "kbId": "2027309239167565824", "qaId": "2030957784421621760" }响应说明
状态码说明
200
认证要求需要 Bearer Token 认证────────────────────────────────────────────────────────────

5. 知识库审核列表

请求方法POST
接口路径/openapi/kb/v1/open/kb/review/list
接口说明知识库审核列表
请求体参数(Body)
参数名类型
pageSizeinteger
pageNuminteger
queryobject
query.tenantIdstring
query.userIdstring
query.statusstring
query.keywordsstring
query.kbIdstring
query.createUserstring
query.recordTypestring
query.reviewTypestring
query.reviewUserIdstring
query.createTimeStartstring
query.createTimeEndstring
query.reviewTimeStartstring
query.reviewTimeEndstring
请求示例{ "pageSize": 20, "pageNum": 1, "query": { "tenantId": "1090", "userId": "2027308192055377920", "status": "REVIEWING", "keywords": "", "kbId": "2027309239167565824", "createUser": "", "recordType": "", "reviewType": "", "reviewUserId": "", "createTimeStart": "2026-02-16 10:44:38", "createTimeEnd": "2026-04-16 10:44:38", "reviewTimeStart": "", "reviewTimeEnd": "" } }响应说明
状态码说明
200
认证要求此接口无需认证────────────────────────────────────────────────────────────

6. 知识库审核

请求方法POST
接口路径/openapi/kb/v1/open/kb/review/doReview
接口说明知识库审核
请求体参数(Body)
参数名类型说明
idstring
tenantIdstring
userIdstring
kbIdstring
reviewResultstring
请求示例{ "id": "2033802172357058560", "tenantId": "1090", "userId": "2027308192055377920", "kbId": "2027309239167565824", "reviewResult": "REJECTED" }响应说明
状态码说明
200

7. 知识库上下线

请求方法POST
接口路径/openapi/kb/v1/open/kb/qa/batch-status
接口说明知识库上下线
请求体参数(Body)
参数名类型
kbIdstring
enableboolean
tenantIdstring
userIdstring
idListarray
queryobject
query.categoryIdstring
query.kbIdstring
query.qastring
query.effectStatusstring
query.qaIdstring
query.enablenull
query.createTimeStartstring
query.createTimeEndstring
query.updateTimeStartstring
query.updateTimeEndstring
请求示例{ "kbId": "2027309239167565824", "enable": true, "tenantId": "1090", "userId": "2027308192055377920", "idList": [ "2033798084168982528" ], "query": { "categoryId": "0", "kbId": "2027309239167565824", "qa": "", "effectStatus": "", "qaId": "", "enable": null, "createTimeStart": "", "createTimeEnd": "", "updateTimeStart": "", "updateTimeEnd": "" } }响应说明
状态码说明
200请求成功

附录:数据类型说明

类型说明
string字符串类型
integer整数类型
boolean布尔类型(true/false)
array数组类型
object对象类型
null空值
2026-08-06