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