探马OpenAPI

新建问答

POST

/api/v3/faqApi/detail/save

keywords最多上传8个

answer中content字段长度不能超过5000

answer中链接类型，link不能为空

answer图片、文件、视频类型createTime字段格式为：“2023-07-27 08:18:06” ，且其他参数不能为空

answe小程序类型，appid不能为空，fileurl不能为空

请求参数

Header 参数

appId

string

应用 appId

必需

默认值:

timestamp

string

请求时间戳

必需

默认值:

sign

string

请求消息签名值

必需

默认值:

appKey

string

应用 appKey

可选

默认值:

Body 参数application/json

question

string

问题名称

必需

groupId

integer

分组id

必需

keywords

array[string]

关键词id

必需

answer

string

答案

必需

answer.type:类型，answer.detail:详情，answer.detail.content:内容，answer.detail.id:文件id，answer.detail.url:文件url，answer.detail.mediaId:文件媒体id，answer.detail.fileName:文件名，answer.detail.createTime:上传创建时间，answer.detail.link:链接地址，answer.detail:title:标题，answer.detail.coverImg:封面图片URl，answer.detail.appid:小程序appid ，answer.detail.fileUrl:封面图URL ，answer.detail.path：页面路径，图片、视频、文件中涉及的参数：mediaId、fileName、createTime、id均由fileUpload接口返回，请求示例中有各个类型answer的格式

示例

{
  "question": "测试文本",
  "groupId": 1476,
  "keywords": [
    "0e37f83f108011ec9f8e00163e106b20"
  ],
  "answer": "[{\"type\":1,\"detail\":{\"content\":\"内容\"}},{\"type\":2,\"detail\":{\"id\":11172,\"url\":\"https://dev.tanmarket.cn/fdfsServer/group1/M00/5F/ED/rBHDtmTCJ6GAIqpmAAFrEmkNNZI904.jpg\",\"mediaId\":\"3LFddu4bG5vt3OIYU_wvyXfgj-CZ7S-ONLYSVdSIMsSsPFpne8-BnLosxqfxSw3Ee\",\"fileName\":\"20230605-094218.jpg\",\"createTime\":\"2023-07-27 08:15:30\"}},{\"type\":4,\"detail\":{\"id\":11173,\"url\":\"https://dev.tanmarket.cn/fdfsServer/group1/M00/5F/ED/rBHDtmTCKD2AUBOWAAFrEn3gRhA862.mp4\",\"mediaId\":\"340mKXmOaTuVBe8l5IUsCfK2Ed_mbXhwT_DyyuyGCs8dMQeLLw85nOJZN9UYBZHIX\",\"fileName\":\"20230605-094218 - 副本.mp4\",\"createTime\":\"2023-07-27 08:18:06\"}},{\"type\":5,\"detail\":{\"id\":11174,\"url\":\"https://dev.tanmarket.cn/fdfsServer/group1/M00/5F/ED/rBHDtmTCKIqALLFYAAFrEndGoLQ75.pptx\",\"mediaId\":\"3hsx3xLkZ7aUXe4sL58supjd4Y7OBOM-LGl7m-X7HoF6OmS4T9-L1WcCT15ZMIGec\",\"fileName\":\"20230605-094218 - 副本.pptx\",\"createTime\":\"2023-07-27 08:19:22\"}},{\"type\":3,\"detail\":{\"link\":\"https://www.baidu.com\",\"title\":\"百度\",\"content\":\"内容\",\"coverImg\":\"https://dev.tanmarket.cn/fdfsServer/group1/M00/5F/AD/rBHTdWTCKKaAHE5xAACY8V6hxS4361.png\"}},{\"type\":7,\"detail\":{\"appid\":\"appid(必填)\",\"content\":\"小程序描述(必填)\",\"fileName\":\"20230605-094218.jpg\",\"fileURL\":\"https://dev.tanmarket.cn/fdfsServer/group1/M00/5F/ED/rBHDtmTCJ6GAIqpmAAFrEmkNNZI904.jpg\",\"path\":\"页面路径(必填)\",\"mediaId\":\"3LFddu4bG5vt3OIYU_wvyXfgj-CZ7S-ONLYSVdSIMsSsPFpne8-BnLosxqfxSw3Ee\"}}]"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/api/v3/faqApi/detail/save' \
--header 'appId;' \
--header 'timestamp;' \
--header 'sign;' \
--header 'appKey: {{appKey}}' \
--header 'Content-Type: application/json' \
--data-raw '{
  "question": "测试文本",
  "groupId": 1476,
  "keywords": [
    "0e37f83f108011ec9f8e00163e106b20"
  ],
  "answer": "[{\"type\":1,\"detail\":{\"content\":\"内容\"}},{\"type\":2,\"detail\":{\"id\":11172,\"url\":\"https://dev.tanmarket.cn/fdfsServer/group1/M00/5F/ED/rBHDtmTCJ6GAIqpmAAFrEmkNNZI904.jpg\",\"mediaId\":\"3LFddu4bG5vt3OIYU_wvyXfgj-CZ7S-ONLYSVdSIMsSsPFpne8-BnLosxqfxSw3Ee\",\"fileName\":\"20230605-094218.jpg\",\"createTime\":\"2023-07-27 08:15:30\"}},{\"type\":4,\"detail\":{\"id\":11173,\"url\":\"https://dev.tanmarket.cn/fdfsServer/group1/M00/5F/ED/rBHDtmTCKD2AUBOWAAFrEn3gRhA862.mp4\",\"mediaId\":\"340mKXmOaTuVBe8l5IUsCfK2Ed_mbXhwT_DyyuyGCs8dMQeLLw85nOJZN9UYBZHIX\",\"fileName\":\"20230605-094218 - 副本.mp4\",\"createTime\":\"2023-07-27 08:18:06\"}},{\"type\":5,\"detail\":{\"id\":11174,\"url\":\"https://dev.tanmarket.cn/fdfsServer/group1/M00/5F/ED/rBHDtmTCKIqALLFYAAFrEndGoLQ75.pptx\",\"mediaId\":\"3hsx3xLkZ7aUXe4sL58supjd4Y7OBOM-LGl7m-X7HoF6OmS4T9-L1WcCT15ZMIGec\",\"fileName\":\"20230605-094218 - 副本.pptx\",\"createTime\":\"2023-07-27 08:19:22\"}},{\"type\":3,\"detail\":{\"link\":\"https://www.baidu.com\",\"title\":\"百度\",\"content\":\"内容\",\"coverImg\":\"https://dev.tanmarket.cn/fdfsServer/group1/M00/5F/AD/rBHTdWTCKKaAHE5xAACY8V6hxS4361.png\"}},{\"type\":7,\"detail\":{\"appid\":\"appid(必填)\",\"content\":\"小程序描述(必填)\",\"fileName\":\"20230605-094218.jpg\",\"fileURL\":\"https://dev.tanmarket.cn/fdfsServer/group1/M00/5F/ED/rBHDtmTCJ6GAIqpmAAFrEmkNNZI904.jpg\",\"path\":\"页面路径(必填)\",\"mediaId\":\"3LFddu4bG5vt3OIYU_wvyXfgj-CZ7S-ONLYSVdSIMsSsPFpne8-BnLosxqfxSw3Ee\"}}]"
}'

返回响应

🟢200成功

application/json

Body

code

integer

必需

message

string

必需

data

string

问答id

必需

示例

{
  "code": 0,
  "message": "success",
  "data": "id"
}

删除分组

删除问答