POST https://open.sobot.com/open/platform/api.json
请求参数(Request Body)
参数名 | 类型 | 必填 | 说明 | |
---|---|---|---|---|
action | 字符串 | 是 | 传值为"search_doc_list" | |
access_token | 字符串 | 是 | 调用接口凭据 | |
data | 对象 | 是 | 详见下文 | |
请求data
参数名 | 类型 | 必填 | 说明 | |
---|---|---|---|---|
keyFlag | 整型 | 是 | 1问题,2答案 | |
questionTypeId | 字符串 | 是 | 词条类型(传-1) | |
robotFlag | 整型 | 是 | 知识库所属机器人:0公共知识库,1机器人一 | |
pageNo | 字符串 | 是 | 当前页码 | |
keyWords | 字符串 | 否 | 搜索关键字 | |
usedFlag | 整型 | 否 | 词条状态,0启用,1手动停用,2系统停用,3过期停用 | |
linkFlag | 整型 | 否 | 是否有关联问题,0是,1否 | |
answerFlag | 整型 | 否 | 答案类型:1文本,2图片,3图文,4视频 | |
createId | 字符串 | 否 | 词条创建人ID | |
createStartTime | 字符串 | 否 | 创建开始时间 | |
createEndTime | 字符串 | 否 | 创建结束时间 | |
updateId | 字符串 | 否 | 词条最后更新人ID | |
updateStartDate | 字符串 | 否 | 更新开始时间 | |
updateEndDate | 字符串 | 否 | 更新结束时间 | |
effectStartDate | 字符串 | 否 | 生效开始时间 | |
effectEndDate | 字符串 | 否 | 生效结束时间 | |
invalidStartDate | 字符串 | 否 | 失效开始时间 | |
invalidEndDate | 字符串 | 否 | 失效结束时间 | |
返回数据
参数名 | 类型 | 说明 | |
---|---|---|---|
code | 字符串 | 执行结果码,1000代表成功 | |
data | 对象 | 详见下文 | |
返回data
参数名 | 类型 | 说明 | |
---|---|---|---|
items | 数组 | 详见下文 | |
pageCount | 整型 | 总页数 | |
pageNo | 整型 | 当前页码 | |
pageSize | 整型 | 每页条数 | |
retCode | 字符串 | 状态码 | |
retMsg | 字符串 | 状态描述 | |
totalCount | 整型 | 总条数 | |
返回items
参数名 | 类型 | 说明 | |
---|---|---|---|
allTypeName | 字符串 | 分类全路径 | |
answerDesc | 字符串 | 答案内容 | |
answerFlag | 整型 | 答案类型:1文本,2图片,3图文,4视频 | |
answerId | 字符串 | 答案ID | |
answerImg | 字符串 | 图文类型的缩略图 | |
answerTxt | 字符串 | 答案纯文本信息 | |
auditStatus | 整型 | 审核状态:0待审核,1永久有效,2指定时间有效 | |
companyId | 字符串 | 公司id | |
docId | 字符串 | 词条ID | |
effectTime | 长整型 | 生效时间 | |
invalidTime | 长整型 | 失效时间 | |
linkFlag | 整型 | 是否有关联问题,0是,1无 | |
matchFlag | 整型 | 匹配模式:0智能匹配,1完全匹配,2包含匹配,3欢迎语匹配 | |
questionId | 字符串 | 问题ID | |
questionTitle | 字符串 | 问题标题 | |
questionTypeId | 字符串 | 问题类型ID | |
questionTypeName | 字符串 | 问题类型名 | |
robotFlag | 整型 | 知识库所属机器人:0公共知识库,1机器人一 | |
smailQuestionNum | 整型 | 相似问法个数 | |
updateId | 字符串 | 更新人ID | |
updateTime | 长整型 | 更新时间 | |
usedFlag | 整型 | 词条状态,0启用,1手动停用,2系统停用,3过期停用 | |
请求示例:
curl https://open.sobot.com/open/platform/api.json
-X POST
-H 'content-type: application/json'
-d '
{
"action": "search_doc_list",
"access_token": "xx",
"data": {
"keyFlag": 1,
"questionTypeId": -1,
"robotFlag": 1,
"pageNo": 1,
"keyWords": "xx",
"usedFlag": 0,
"linkFlag": 1,
"answerFlag": 1,
"createId": "xx",
"createStartTime": "yyyy-MM-dd",
"createEndTime": "yyyy-MM-dd",
"updateId": "xx",
"updateStartDate": "yyyy-MM-dd",
"updateEndDate": "yyyy-MM-dd",
"effectStartDate": "yyyy-MM-dd",
"effectEndDate": "yyyy-MM-dd",
"invalidStartDate": "yyyy-MM-dd",
"invalidEndDate": "yyyy-MM-dd"
}
}'
返回示例:
{
"code": "1000",
"data": {
"items": [
{
"allTypeName": "xx",
"answerDesc": "xx",
"answerFlag": 1,
"answerId": "xx",
"answerImg": "xx",
"answerTxt": "xx",
"auditStatus": 1,
"companyId": "xx",
"docId": "xx",
"effectTime": 1481731200,
"invalidTime": 4102415999,
"linkFlag": 1,
"matchFlag": 0,
"questionId": "xx",
"questionTitle": "xx",
"questionTypeId": "xx",
"questionTypeName": "xx",
"robotFlag": 1,
"smailQuestionNum": 0,
"updateId": "xx",
"updateTime": 1481789852,
"usedFlag": 0
}
],
"pageCount": 3,
"pageNo": 1,
"pageSize": 15,
"retCode": "000000",
"retMsg": "操作成功!",
"totalCount": 40
}
}