新增文件知識

新增網頁或文章知識。

請求

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": ""
}