新增常見問題

新增一條常見問題知識。

請求

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

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	是	常見問題必須傳 4
mc	string	是	問題標題，1 至 255 個字元
nr	string	是	答案內容，1 至 2000 個字元
xs_mc	string[]	否	相似問題標題，最多 10 條

請求示例

{
  "appid": "your-appid",
  "timestamp": 1735689600,
  "ranstr": "random-string",
  "lx": 4,
  "mc": "如何重置密碼？",
  "nr": "請使用登入頁上的密碼重置連結。"
}

返回響應

200 成功

參數名	類型	必填	說明
code	integer	是	1 正常，-1 失敗
msg	string	是	響應信息
data.id	integer	是	本次新增的主要知識庫 ID
data.ids	integer[]	是	本次實際建立的全部 ID，包含相似問題

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

錯誤示例

{
  "code": -1,
  "msg": "參數錯誤",
  "data": ""
}