帮助中心首页
开发者文档
机器人开放接口

查询知识库词条列表

请求方法

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