跳至主要内容

新增常见问题

新增一条常见问题知识。

请求

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

参数名	类型	必填	说明
`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": ""
}

请求
返回响应
- 200 成功
- 错误示例