新增文档知识

新增网页或文章知识。

请求

POST https://apichat.twt.com/openapi/zhishi/create_doc

Header 参数

参数名	类型	必填	说明
x-chat-signature	string	是	HMAC-SHA256 签名
Accept	string	否	默认值：application/json
Content-Type	string	是	application/json

Body 参数

参数名	类型	必填	说明
appid	string	是	应用标识
timestamp	integer	是	请求时间戳
ranstr	string	是	随机字符串
lx	integer	是	1 表示网页，2 表示文章
url	string[]	网页必填	待解析的网页地址，最多 10 条
mc	string	文章必填	文章标题，1 至 255 个字符
nr	string	文章必填	文章内容，1 至 2000 个字符

请求示例

{
  "appid": "your-appid",
  "timestamp": 1735689600,
  "ranstr": "random-string",
  "lx": 2,
  "mc": "使用入门",
  "nr": "欢迎使用本产品。"
}

返回响应

200 成功

参数名	类型	必填	说明
code	integer	是	1 正常，-1 失败
msg	string	是	响应信息
data.id	integer	是	本次新增的主知识库 ID
data.ids	integer[]	是	本次实际创建的全部 ID；多个网页地址可能创建多条知识

{
  "code": 1,
  "msg": "ok",
  "data": {
    "id": 1002,
    "ids": [1002]
  }
}

错误示例

{
  "code": -1,
  "msg": "参数错误",
  "data": ""
}